Feats

Please feel free to join my discord if you run into issues or have ideas! https://discord.gg/mKgxyk6qvb

…or you just want to hangout

Overview

Feats turns everything you already do in Hytale into something worth tracking. Break your first block, light up your base with torches, discover new zones, smelt an adamantite bar, swim a kilometre, tame an animal, walk 500 kilometres or bring down the Gobliterator on hard mode without a scratch, and the game notices. Each feat has a rarity tier and a point value, so players can compare progress with /feats top and chase the rare Platinum feats.

The mod is a server plugin with a small UI asset pack bundled in the jar. It works in singleplayer worlds and on dedicated servers alike, and players join with an unmodified client. The World tab adds server milestones everyone shares in and server firsts that only one player can ever hold, and a scan credits players for what they did before Feats was installed. Server owners get admin commands, optional rewards, a Discord webhook, PlaceholderAPI placeholders and a JSON export, and plugin developers get a public API with an unlock event.

Features

New in 1.4

• 109 new feats worth 7,205 points take the total to 327 feats and 15,075 points.
• Every long running counter gets a further step, from Circumnavigator at 500 kilometres and Million Mark at a million blocks to Mythic at 25,000 defeats and Goblin Bane at 2,500 goblins.
• A second step for every metal, every ability and every Chapter I collection, from Copper Magnate to Overcharged and Silk Merchant.
• New sets. Pick Collector, Sword Collector, Copper Kit, Cobalt Clad, Thorium Plate, Crop Rotation for all 14 crops and Full Net for 15 kinds of fish.
• New counters for swimming, gliding, riding, taming, kill streaks, the biggest single hit, the longest session and the floor and top of the world, behind Sea Legs, Wingspan, Saddle Up, Tamer, Rampage, Overkill, Marathon, Bedrock Bound and Head in the Clouds.
• Glazier, Stonemason, Timber Frame and Arborist for building with glass or windows, stone, wood and saplings.
• Fourteen new hidden feats, among them Untouchable for a boss fight without a scratch and Speedrunner for a fast Gobliterator.
• Three new server firsts. Founder, Warpath and Surveyor.
• Tracking is faster and allocates nothing on the busy paths, so a big server never feels it.

327 feats in nine categories

Tiers and points

That adds up to 15,075 points for a player who earns everything. Of those feats, 29 are hidden. They show as ??? with a chest icon until you earn them, so there is still something left to discover.

Some feats need several things at once. Goblinologist asks for one of every kind of goblin, Ironclad, Copper Kit, Cobalt Clad, Thorium Plate and Adamant Wall ask for every piece of an armour set, Pick Collector and Sword Collector ask for one of every metal, Crop Rotation and Full Net ask for every crop and 15 kinds of fish, and Full Armoury asks for ten different kinds of weapon. These show a "steps" counter instead of a single number.

Meta feats chain off each other. Getting Started, Achiever, Overachiever, Legend of Orbis, Icon and Completionist unlock at 10, 25, 50, 100, 150 and 250 feats.

Exploration

The zone ladder matches the five zones the default world names on discovery. New Horizons, Sightseer, Cartographer, Pathfinder and Master Explorer ask for 1, 2, 3, 4 and all 5 zones. The distance ladder now runs to Circumnavigator at 500 kilometres, the chest ladder to Vault Breaker at 2,500 chests, and Sea Legs, Wingspan, Bedrock Bound and Head in the Clouds reward a kilometre swum, five kilometres on a Scrap Glider, and standing at the floor and the top of the world.

Chapter I

The Chapter I tab holds 105 feats worth 4,650 points for everything that arrived with Hytale 0.7.0. Version 1.2.0 adds the endgame, and 1.4.0 carries the goblin, spider, Void, ability, portal and collection ladders a step further.

• Goblins and the Void. A goblin ladder from Goblin Slayer to Goblin Bane at 2,500, Goblinologist for one of every kind of goblin, Know the Void for every kind of Voidspawn, spiders up to Arachnid Apex, Void Spectres, anomaly crystals and the anomaly keystone.
• Bosses. Defeat the Goblin Feastmaster, the Gobliterator, the Voidtaken bear, the Revenant Guardian and The Hedera in The Dread Wade. Every one of them counts toward Giant Killer, Boss Rush and Boss Hunter, and every player who hit the boss in the last minute of the fight gets the credit.
• The finale. Craft the key to The Deepworks, step through the Dungeon Completion Portal after the Gobliterator falls and trade two Gobliterator Cores for the largest backpack.
• Hard mode and challenges. A set of hidden feats waits for players who press the hard mode button, survive a whole run of The Deepworks, face the Gobliterator with nothing to lose, beat it five times on hard mode or beat it within 20 minutes of entering.
• Runestones and abilities. Craft all seven Ability Runestones and all eight Modifier Runestones, cast up to 25,000 abilities and master each of Fireball, Ground Slam, Enrage, Imbue Poison, Wind Strike, Chain Hook and Charged Shot twice over.
• Gadgets and gear. Build the Scrap Drill, the Scrap Glider, Rocket Boots, the Hookshot and the Spyglass, craft Bangsticks and repair kits, and fill a whole armoury.
• Portal worlds and Fragments. Enter the Goblin Breach, The Deepworks and three different kinds of portal world, build an Ancient Gateway, enter all five Fragments it can reach and keep going to Frequent Flyer at 100 portal worlds.
• Dungeons, loot and lore. Use the Goblin Lab bench, repair a Breach Console, collect Voidhearts, Runestone Shards, Scraps, Coffer Keys and Spider Silk from drops and chests, and collect all twelve lore notes.
• Memories and decoration. Record up to 100 Memories, mine Kenolite, Void crystal and shiny scrap piles, decorate with goblin furniture and metal blocks up to Steelworks, and hang one of each goblin painting.

Memories are a server wide race in Hytale 0.7.0. Once any player hands a Memory in, nobody else on the server can record that one, so on a busy shared server the higher Memory feats may be out of reach. Solo and in co-op this is fair.

Parked feats

Five feats point at content that ships in the 0.7.0 assets but never appears in a survival world. Mithril Miner and Mithril Smith need mithril ore, Onyx Eye needs onyxium ore and Prismatic needs prisma ore, none of which world generation places. Silver Bullet needs a werewolf, and werewolves never spawn. These feats are parked. They are not shown, not counted and not earnable, and they come back with the same ids once the content reaches the world. Full Spectrum stays, now asking for every metal that is actually generated, at Gold.

World milestones and server firsts

The World tab holds 18 feats that belong to the server rather than to one player. They are not part of the 327 feats or the 15,075 points and never count toward anyone's completion.

• Nine world milestones, reached once for everyone. Lights On, Full Steam, Engine Room and Pressure Rising for restoring power to the Goblin Lab and repairing its Boiler, Engine and Compressor, then Scrap Yard, Redline, End of the Chapter, Open Gates and Uprooted the first time anyone beats the Gobliterator, beats it on hard mode, completes Chapter I, builds an Ancient Gateway or defeats The Hedera.
• Nine Platinum server firsts. Pioneer, Trailblazer, Historian, Keeper of Memories, Gatewright and Party Crasher go to the first player on the server to defeat the Gobliterator, step through the Dungeon Completion Portal, record 50 and 100 Memories, build an Ancient Gateway or defeat the Goblin Feastmaster. Founder, Warpath and Surveyor go to the first to unlock 100 feats, defeat 5,000 creatures and discover all 5 zones.

The player who raises a milestone gets it with a toast and its points. Everyone else sees it as achieved in the World tab and gets a quiet chat line such as "Server milestone reached, Lights On, by Steve", and players who were offline get it on their next join. The Goblin Lab milestones come from the game's own flags, checked every 5 seconds, and credit whoever used a Goblin Lab device in the last minute, or nobody when no one did. A first is held by one player forever. When two players finish the same fight together, exactly one of them gets it.

Stats tracked

Feats keeps 35 lifetime totals per player and shows them on the Statistics tab.

• Time played, longest session and sessions
• Distance travelled, swum, glided and ridden, and zones discovered
• Blocks broken, ore mined, logs chopped and blocks placed
• Items crafted, items picked up, crops harvested and fish caught
• Kills, ranged kills, boss kills, deaths, best kill streak and biggest hit
• Damage dealt and damage taken
• Animals tamed
• Chests opened, nights slept and benches used
• Abilities cast, portals entered and Memories recorded
• Meals eaten and potions drunk
• Chat messages and feats unlocked

Behind those totals Feats also counts specific ores, item groups (pickaxes, tools, weapons, armour, bars, food, potions, furniture, benches), placed groups (torches, lanterns, beds, chests, crops, saplings, glass and windows, stone, wood, metal), creature groups (undead, goblins and each goblin kind, spiders, Trorks, Outlanders, Scaraks, Feran, Kweebecs, Void creatures and each kind of Voidspawn, golems and spirits, dragons, bosses, livestock, predators), each ability you cast, the Chapter I items that reach your inventory, each kind of portal world you enter and causes of death, fire and lava included. Feats are defined against these groups, so "any pickaxe" or "any ore" just works.

The counters are hard to farm. Chat counts at most one message every 5 seconds, breaking a block you just placed earns nothing, and picking up items you just dropped does not count again. Creative mode is ignored by default, and whole worlds such as a lobby can be left out. The tracking is cheap too. Block, item and creature ids are classified once and remembered, and a whole event updates a player's counters and checks their feats in one pass, so a block break, kill or pickup costs well under a microsecond and allocates nothing.

Unlock toasts

When a feat unlocks you get the game's own notification toast with the feat's icon, name and description, plus the Memories unlock sound. Platinum feats also show a big title in the middle of the screen. A chat line confirms the tier, the points and your new total, for example Feat unlocked Rock Bottom (Bronze, +10 pts, 2/327), and rare feats add a tag such as "(rare, 3% of players)".

On a server with other players online, Silver and better unlocks are announced to everyone else in chat. The minimum tier, the sound and the big title tier are all configurable, and each player can mute their own toasts and sounds with /feats notify off.

The feats page

/feats opens a two column browser.

• The left column shows your name, your unlocked count, a progress bar and your points with a completion percentage.
• Below that are the tabs. All feats, one tab per category with its own count, the World tab, Unlocked (newest first) and Statistics.
• Every feat row has an icon, name, description, tier, a progress bar and a progress line such as 37 / 100 · +10 pts. Unlocked rows show a check mark and the date you earned them.
• Once enough players have played, each row also shows how many players own the feat, such as "12% of players", and marks rare feats.

The World tab counts what the server has achieved, such as "4 / 18 achieved". Each row says "Not yet achieved" or "Unclaimed", or who achieved it or holds it and when.

/feats view opens the same browser read only on another player.

Leaderboard, rarity and sharing

/feats top prints the ten highest scoring players the server has ever seen, including players who are offline. Each line shows points and unlocked count, and your own name is highlighted. /feats recent lists the last ten unlocks on the server, /feats compare puts your progress next to another player's per category, and /feats share posts one of your feats to everyone online with its tier, date and rarity.

Titles

Players can wear one of their Gold or Platinum feats as a title in front of their chat lines, in the tier's colour. Titles show in chat only when no other plugin formats chat, so a chat formatting plugin always keeps control.

Rewards

Rewards are off by default. Set RewardsEnabled to true in Feats.json and run /feats admin reload or restart the server. Feats then writes Rewards.json as an empty template on first start. Nothing is handed out until you fill it in and reload again.

Rewards can run console commands, add permissions, add the player to a group and send a chat message. They can be tied to a single feat, to every unlock of a tier, to a points total or to a number of unlocked feats. Commands and messages can use the player name, the uuid, the feat id and name, the tier and the new points total. Each reward is given once per player and is remembered through a reset, so it cannot be farmed. Reward commands run one every 100 ms, so a big catch up never floods a tick.

Admin commands

Admin permissions. Admin commands need two generated permission nodes at once. A sender needs ryvrook.feats.command.feats.admin and the node of the sub command, ryvrook.feats.command.feats.admin.<sub>, for example ryvrook.feats.command.feats.admin.grant. One without the other is not enough. The server console has every permission. Every other Feats command is open to all players.

The full forms are /feats admin grant <player> <feat> [--rewards], /feats admin revoke <player> <feat>, /feats admin reset <player> confirm and /feats admin setstat <player> <key> <value>. They work on offline players too, and everything except view works from the server console.

Scanning existing worlds

Installing Feats on a world that has been running for months no longer means starting from zero. Run /feats admin scan all --dry-run to see what would change, then /feats admin scan all to apply it, or name one player in place of all.

• The scan only uses what Hytale records, never inventories. It reads discovered zones, recorded Memories, death markers and the first spawn.
• The engine keeps at most five death markers per world, so the death count it gives is a lower bound.
• Respawn points, discovered instances and known recipes are not read.
• Counters are only raised, so running it a second time changes nothing.
• Online players unlock at once with the usual toasts. Offline players are updated on the Feats thread and unlock at their next join, and a player Feats has never seen gets a fresh file.
• A scan of everyone runs in batches of 25 and also backfills milestones and firsts, each going to the player with the earliest existing unlock. Run it once after every upgrade that adds firsts, such as 1.4.0.

Discord

The Discord webhook is off until a URL is set. With DiscordWebhookUrl filled in, Gold and Platinum unlocks are posted to your channel as embeds in the tier's colour, with the description, the points and the rarity. Posts run on a background thread at most one every 2 seconds, Discord rate limits are respected and player names can never ping anyone. The minimum tier is configurable.

PlaceholderAPI

PlaceholderAPI is optional. When it is installed, Feats registers the feats expansion. The placeholders are %feats_points%, %feats_unlocked%, %feats_total%, %feats_total_points%, %feats_rank%, %feats_title%, %feats_last%, %feats_rarity_<featId>%, %feats_stat_<key>%, %feats_has_<featId>%, %feats_first_<featId>% for the holder of a server first and %feats_milestone_<featId>% for whether a world milestone is reached. Without PlaceholderAPI Feats loads as usual.

For plugin developers

The dev.ryvrook.feats.api.FeatsApi class reads points, rank, unlocks, progress, titles and counters, adds to counters, grants feats, lists the world milestones and server firsts and registers unlock listeners. Every unlock also fires FeatUnlockedEvent on the server's event bus. The API is stable and methods are only ever added.

FeatsApi feats = FeatsApi.get(); // null when Feats is not loaded
if (feats != null) {
    int points = feats.points(uuid);
    feats.onUnlock(event -> System.out.println(event.playerName() + " unlocked " + event.featName()));
}

Leaderboard export

Feats writes export/feats.json with the top 100 players, the last 50 unlocks, the rarity of every feat and the world milestones and server firsts with who reached them and when, so web maps such as Atlas and other tools can show a leaderboard without linking against Feats.

Safe storage

Progress is kept in memory while a player is online and written to players/<uuid>.json on autosave, on disconnect and on shutdown. Saves run on a dedicated Feats thread so they never hold up the game. Session length is written every five minutes as well, so a crash loses at most five minutes of it, and a plugin reload does not split a session. Milestones and firsts are kept in server.json in the Feats data folder and read before anyone joins. Files are written atomically, and a damaged file is set aside so the player starts fresh instead of breaking the server.

When a player joins, every feat is checked once against their counters, so catch up at join unlocks feats whose counters are already met. Players upgrading from an older version get the new feats they already qualify for on their next join.

Getting started

1. Download Feats-<version>.jar.
2. Put it in your Mods folder.
   • Windows %APPDATA%\Hytale\UserData\Mods
   • macOS ~/Library/Application Support/Hytale/UserData/Mods
   • Dedicated server, the server's mods/ directory
3. Start the world or server. Tracking begins the moment a player joins, and the first join unlocks Welcome to Orbis.
4. Type /feats to open the browser.

Commands

Player commands work on the player who runs them. /feats view and /feats compare can be turned off with AllowViewOthers. The admin commands are listed above.

Configuration

Feats.json is created in the mod's data folder on first start. Edit it and run /feats admin reload, or restart the server.

PausePlaytimeWhenDisabled defaults to true and also stops time played in Creative mode and disabled worlds. Set it to false to keep time played counting there. The default UnlockSound is SFX_Memories_Unlock_Local, and a DisabledWorlds value looks like ["creative", "lobby"]. A player counts toward rarity with at least one unlock or 10 minutes of play time.

/feats admin reload applies every key without a restart except AutosaveSeconds and ExportSeconds, which keep their old timing until the server restarts.

Player progress lives in players/<uuid>.json next to the config. Delete a file while that player is offline to reset them. World milestones and server firsts live in server.json in the same folder, each with the time and the player who raised or holds it.

Compatibility

• Feats 1.4.0 is built against the Hytale 0.7.1 server and still runs on the 0.7.0 release server.
• Feats 1.1.0 and later need the Hytale 0.7.0 release server (Chapter I) or newer, because the Chapter I feats rely on events that older servers do not have.
• Feats 1.0.0 remains available for 0.6.8 servers.
• Pre-release servers log a version range warning because they report a pre-release version, and the plugin still loads.
• Works in singleplayer worlds and on dedicated servers.
• No client mod is needed. The UI files ship inside the jar as an asset pack.
• No other mods are required. PlaceholderAPI is optional.

Changelog

1.4.0

• 109 new feats worth 7,205 points. 327 feats and 15,075 points in nine categories, plus 18 world feats.
• Longer ladders. Circumnavigator, Vault Breaker, Million Mark, Deep Vein, Megastructure, Assembly Line, Mythic, Apocalypse, Immortal, Boss Hunter, Old Timer, Long Winter, Clear Cut, Old Growth, Harvest Moon, Dragon's Hoard, Sea Legend, Loudspeaker, Icon and Completionist.
• Ore and metal. Copper Magnate, Ironbound, Gold Standard, Silver Service, Cobalt Crown, Thorium Reactor and Adamant Heart.
• Building and crafting. Light of Orbis, Festival of Lights, Bed and Breakfast, Show Home, Industrial Park, Grand Vault, Glazier, Stonemason, Timber Frame, Arborist, Master Toolmaker, Arms Dealer, Quartermaster, Foundry, Banquet, Apothecary and Master Carpenter.
• Sets. Pick Collector, Sword Collector, Copper Kit, Cobalt Clad, Thorium Plate, Crop Rotation and Full Net.
• Combat and survival. Marksman, Lich Bane, Trork Scourge, Outlander Outlaw, Hive Breaker, Feran Hunter, Elemental Master, Gladiator, Warmonger, Fixture, Part of the Furniture, Death Wish, Respawn Point, Bench Veteran, Bottomless, Potion Problem, Hot Stuff and Lava Bath.
• New counters. Sea Legs, Wingspan, Saddle Up, Bedrock Bound, Head in the Clouds, Tamer, Rampage, Overkill, Untouchable, Marathon and Speedrunner.
• Nature and Chapter I. Timber, Breadbasket, Granary, Abattoir, Apex Predator, Goblin Bane, Arachnid Apex, Void Reaver, Grand Archmage, Inferno, Tremor, Berserker, Plaguebringer, Tempest, Hooked, Overcharged, Frequent Flyer, Breach Veteran, Deepworks Regular, Scrap Dealer, Hard Habit, Rune Lord, Rune Hoard, Scrap Baron, Silk Merchant, Key Ring, Kenolite Quarry, Crystal Cavern and Steelworks.
• Three server firsts. Founder, Warpath and Surveyor.
• New lifetime totals on the Statistics tab for distance swum, glided and ridden, best kill streak, biggest hit, animals tamed and longest session.
• Tracking is faster and allocates nothing on the busy paths. A block break, kill or pickup takes about a tenth of a microsecond, down from up to 850 ns, and a whole event updates every counter and checks every feat in one pass.
• Session length is saved every five minutes and survives a plugin reload, lava deaths count as fire and lava, and windows count as glass since the game has no survival glass block.
• Builds against server 0.7.1 and still runs on 0.7.0.
• Players who already pass a new target get it on their next join. Run /feats admin scan all once after upgrading so the new server firsts go to the earliest existing unlocks.

1.3.0

• After upgrading, run /feats admin scan all once so firsts and milestones go to the earliest existing unlocks.
• A World tab with 15 server feats. Nine world milestones, from Lights On in the Goblin Lab to Uprooted, and six Platinum server firsts, from Pioneer to Party Crasher. They never count toward totals or completion.
• The player who raises a milestone gets its points, and everyone else gets a chat line and sees it in the World tab. A first is held by one player forever.
• The Goblin Lab milestones follow the game's own flags, checked every 5 seconds, and credit whoever used a lab device in the last minute.
• /feats admin scan with a dry run catches counters up from discovered zones, recorded Memories, death markers and the first spawn, and backfills milestones and firsts.
• Records are kept in server.json and appear in the export, the API and two new placeholders.
• The zone feats ask for 1, 2, 3, 4 and all 5 zones, so Master Explorer can finally be earned.

1.2.1

• Loading a new jar with a different file name on a running server no longer fails with a duplicate asset pack.

1.2.0

• The Chapter I endgame. Chapter Closed, Under Pressure, Bigger Pockets, Scrap Metal, Weed Killer for The Hedera, Fragments of Orbis, Gatekeeper, Overtime, Loremaster, Gallery Opening, Archivist, Living Memory, Keystone, Goblinologist and Know the Void, plus four new hidden feats. Adamant Wall and Adamant Edge join Crafting. 218 feats and 7,870 points.
• Boss kills credit every player who hit the boss in the last 60 seconds, not only the killing blow.
• Flip the Switch now tracks the hard mode button The Deepworks actually uses.
• Five feats for content the game never places are parked, five goblin kind feats are folded into Goblinologist, and Full Spectrum no longer needs mithril.
• Rebalanced tiers and categories. Per ability cast feats are Bronze, food and potion feats moved to Survival, Duke Dethroned moved to Combat and Goblin Slayer opens the Chapter I goblin ladder.
• Optional rewards from Rewards.json, off by default.
• Admin commands for view, grant, revoke, reset, setstat, reload and rates, behind generated permission nodes.
• Player commands view, compare, title, notify, recent and share.
• Rarity in the browser, the chat line, the export and /feats share. Titles in chat. Big titles for Platinum unlocks and a configurable unlock sound.
• Creative mode and chosen worlds can pause every counter.
• Discord webhook, PlaceholderAPI placeholders and a public API with FeatUnlockedEvent.

1.1.0

• Chapter I tab with 71 new feats covering goblin breaches, portal worlds, the Gobliterator, the Feastmaster, hunt sites, memories, runes, gadgets and the new weapon families. 207 feats and 7,395 points in nine categories.
• Tracks ability casts and interactions, items obtained through crafting, looting and trading, portal worlds entered, and memories collected.
• Writes a leaderboard file to export/feats.json for the Atlas live map.
• Needs the Hytale 0.7.0 release server. Use 1.0.0 on 0.6.8.

1.0.0

• First release. 136 feats in eight categories, lifetime statistics, a points leaderboard, unlock toasts with a sound and the /feats browser.
• The feats commands are open to every player.

Links

• Source code https://github.com/ryvrook/feats.git
• Discord https://discord.gg/mKgxyk6qvb
• More mods by ryvrook https://www.curseforge.com/members/ryvrook/projects

License

MIT. Made by ryvrook.