本页面尚未翻译成简体中文,因此以英文显示。 英文版本

← All mods Expansions · Society

NEROTROPHIES

Track · Achieve · Celebrate

Earn trophies for what you do across every Neroland mod, then put them on display: pedestals, cabinets and plaques that turn your base into a record of everything you have achieved.

Beta v0.1.0-beta.1
NeroTrophies logo

NeroLink App — Beta Explore the Neroland ecosystem

📱 NeroLink App Beta — your Neroland world on your phone. Check energy, alerts and machines live, claim quest rewards and search your storage without logging in. Join the beta at nerolandmc.net →

🌌 Explore the Neroland ecosystem. See how NeroTrophies fits together with the rest of the Nero mods — every mod, wiki and changelog in one place. View the ecosystem at nerolandmc.net → · NeroTrophies on the website


NeroTrophies is the achievement layer of the Neroland ecosystem. It listens for milestones from vanilla Minecraft, Neroland Core and every Nero mod you have installed, and awards trophies in four tiers. Each trophy is a real block you can place, and it carries the gamertag of the player who earned it. Group them into collections, show them off in cabinets that light up as a collection fills, and follow your progress in the Trophy Book or in the NeroLink app.

Built on Neroland Core, the only mod it requires. Every other Nero mod is optional: its trophies simply appear when it is installed.

(Beta — 0.1.0-beta.1, the first feature release.)


What it adds

  1. 152 trophies to start with. Trophies for vanilla Minecraft and Neroland Core, plus a set for every Nero mod: first rocket launch and every world visited in Nerospace, faction ranks, boss studies and bestiary progress, harvest milestones, ruin codices, colony growth, arcade play and more. Sixteen of them are hidden and show as "???" until you earn one.
  2. Four tiers. Bronze, silver, gold and nero, each with its own trophy model, toast, sound and particles. Nero trophies are the rare ones, kept for each mod's hardest milestone.
  3. Twenty collections. Named sets such as Astronaut, Boss Hunter and Codex, including collections that span several mods. Completing one unlocks a cabinet trim, and some award a trophy of their own.
  4. Trophies that show who earned them. One trophy block renders any trophy: a tier base, a miniature of the trophy's icon and a nameplate engraved with the earner's gamertag. Place it, move it, gift it — it always shows who earned it.
  5. Display blocks. They hold your trophies, or any other item you want to show off. A Display Pedestal with a slow turntable and comparator output by tier, a Trophy Cabinet and a slim Wall Cabinet that join side by side, bind to a collection and show ghost outlines for the trophies still missing, a Trophy Plaque with the trophy's title and earner, and a Trophy Spotlight to light your hall. Pedestals and cabinets take a colour finish from dyes — and from NeroDecor's colour tools when NeroDecor is installed.
  6. The Trophy Book. A tab per mod, progress bars, tier filters, your collections and the re-claim button. Craft it, or bind a key to open it in Controls.
  7. Re-claim, never duplicate. Lost a trophy? Re-claim it from the book. The new copy is genuine and the old one becomes a dull replica — no name, still decorative, never counted by a cabinet — so there is only ever one genuine copy of each trophy.
  8. Earned for what you've already done. When a trophy is added later, or you join a server with progress behind you, it is awarded for work you've already done — quietly, without a burst of announcements.
  9. The trophy gallery. /nerotrophies gallery (creative, operators) builds a walkable hall with every trophy, tier, display block, finish and trim, and /nerotrophies gallery clear puts the area back exactly as it was.
  • 🏆 Your trophy wall. Every trophy grouped by mod, with tier filters and progress bars, a detail page for each one, and your collections.
  • 🔔 Optional notifications when you earn a trophy or complete a collection — off by default, and they name the trophy only.
  • 🔒 Only your own record. The app shows your trophies and nobody else's: no leaderboards, no other players' names, no coordinates.

For pack makers and mod authors

Trophies and collections are plain JSON under data/<namespace>/neroland_trophies/ and data/<namespace>/neroland_trophy_collections/. Six trigger types cover advancements, Neroland events, statistics, items obtained, blocks placed and dimensions visited. Any mod can award a trophy directly through Neroland Core's trophy API, without depending on NeroTrophies. A trophy for a mod that isn't installed is skipped quietly. See Adding Trophies on the wiki.

Fair by design

  • 🎖️ A record, never a gate. Trophies are cosmetic. Nothing in any Nero mod needs a trophy to be reachable.
  • 🪙 Optional coin rewards through Neroland Core's currency, off by default, paid only once per trophy and never for re-claims or past progress.
  • 📣 Announcements in chat for gold and nero trophies, which each player can turn off for themselves.

Privacy (POPIA / GDPR)

NeroTrophies stores one record per player, under their player UUID: the trophies they earned and when, a random claim token per trophy, completed collections and trims, which rewards were paid, their last-known gamertag (so their trophies can show it) and two toggles. Trophy items, blocks and cabinets hold only a trophy id and a token — never a name or a UUID. A trophy's gamertag is shown to other players who can see that trophy; turn that off any time with /nerotrophies showname off. Get a copy of your record with /nerotrophies export. Erase everything with Neroland Core's /neroland data eraseme: every trophy you earned, wherever it is in the world, shows no name from that moment, and your NeroTrophies data is cleared alongside every other Neroland mod. Inactive records follow Neroland Core's retention setting.

Telemetry notice: NeroTrophies contains opt-out, anonymous crash reporting via Sentry (EU servers) — on by default. A report carries only the stack trace of an error in NeroTrophies code, the mod/game/loader/Java versions and the list of loaded mod ids — never IPs, usernames, UUIDs, gamertags, positions, world data or chat. Opt out any time by setting telemetryEnabled=false in config/nerotrophies.properties. Full details: PRIVACY.md.

Why it fits the ecosystem

  • 🧩 Built on Neroland Core — the trophy registry and API live in Core, so every Nero mod and datapack can add trophies; NeroTrophies records them, displays them and shares them with the app. It uses Core's shared per-player erasure hook and ships in its own creative tab.
  • 📱 NeroLink module — your trophy wall in the companion app.
  • 🤝 Interoperates, never hard-depends — every sibling's trophies are inert data that light up when that mod is installed. NeroTrophies works in full on Core alone.
  • 🧱 Cross-loader — NeoForge, Forge and Fabric on Minecraft 1.21.1 to 1.21.11 and 26.1.2, 26.2 and 26.3.

Requirements & compatibility

  • Requires Neroland Core 1.20.0 or newer — install it alongside NeroTrophies (it loads first).
  • Minecraft 1.21.1, 1.21.4, 1.21.5, 1.21.8 (also 1.21.7), 1.21.10 (also 1.21.9), 1.21.11, 26.1.2, 26.2 and 26.3, on NeoForge, Forge and Fabric (Fabric also needs Fabric API).
  • Optional: NeroLink for the app, any other Nero mod for its trophies, NeroQuests for the "Hall of Fame" quest chapter and NeroDecor for extra finishes. NeroTrophies is complete without them.
  • Modpacks are allowed and encouraged — any platform, no need to ask. Use the official files and credit NeroTrophies by Neroland with links to this page and the GitHub repository. Full terms: LICENSE.
  • 📖 Wiki — getting started, the Trophy Book, tiers, display blocks, collections, the full trophy catalogue, adding trophies, commands and config.
  • 💬 Discord — chat, help, and sneak peeks.
  • 🐞 Issues — bug reports and feature requests.
  • 🗒️ Changelog
  • 🔥 Also on CurseForge

Created by Neroland. The project logo was made with the help of AI image tools; in-game art is generated by the project's own tooling and refined by hand.

Latest release

v0.1.0-beta.1

First feature release. Requires Neroland Core 1.20.0 (the release that adds Core's trophy API).

Added

  • Trophy engine. NeroTrophies is Neroland Core's trophy provider. Trophies are defined in JSON under data/<namespace>/neroland_trophies/ and collections under data/<namespace>/neroland_trophy_collections/; any mod or datapack can add more, and other mods can award one directly through Core's TrophyApi.award. Awards are recorded once, each with a random claim token, and are followed by collection completion (with its cabinet trim and optional completion trophy), the optional coin reward, the chat announcement and the toast.
  • Six trigger types: advancement, nero_event (player-scoped progression gates, material milestones, reputation and currency crossings), stat, item_obtained, block_placed and dimension_visited. Ids are matched as strings, so trophies for mods that aren't installed cost nothing and are skipped quietly.
  • Retroactive awards: on login, datapack reload and /nerotrophies reload, players are re-checked within a per-tick budget, so trophies added later are awarded for work already done (silently, without coins).
  • Four tiers — bronze, silver, gold and nero — each with its own model, toast, sound and particles.
  • Starter catalogue: 152 trophies across Neroland Core, vanilla Minecraft and every Neroland mod (bronze 63, silver 52, gold 30, nero 7; 16 hidden until earned) and 20 collections, including cross-mod ones. Each lights up only when its mod is installed.
  • One trophy item and block that renders any trophy: a tier base, a miniature of the trophy's icon and a nameplate engraved with the earner's gamertag. The item stores only the trophy id and its claim token.
  • Display blocks: Display Pedestal (slow turntable, comparator output by tier), Trophy Cabinet and Wall Cabinet (join side by side, bind to a collection, show ghost outlines for missing trophies and the collection's trim), Trophy Plaque (title and earner) and Trophy Spotlight. The pedestal, cabinets and plaque hold any item, one per slot, kept whole with all its components (only genuine trophies count toward a collection; a plain item gives comparator output 1; very large items reach other clients as their plain item). Pedestals and cabinets take a colour finish from dyes or Core materials, and from NeroDecor's colour tools when NeroDecor is installed.
  • Trophy Book: a tab per mod, progress bars, tier filters, collections, hidden trophies shown as "???", and re-claim. Opens from the item or a keybind.
  • Re-claim: mints a new token so a lost copy becomes a dull replica (no name, never counted by a cabinet); there is only ever one genuine copy. 10-minute cooldown; never pays coins.
  • Award feedback: award toast for a trophy, a completed collection and a login summary; tier sounds (original, with subtitles) and particles.
  • NeroLink: a nerotrophies link module (schema 1) that serves only the asking player's own trophies, collections and counts, plus trophy-earned and collection-completed events (push category nerotrophies, off by default; the message names the trophy only).
  • /nerotrophies gallery (creative, players only): a walkable hall with a bay per mod, a tier row, a genuine trophy beside its replica, a cabinet per collection in empty, partial and complete states, every finish and trim, and a demo plate for the toast and sound. Gallery copies use a placeholder name, award nothing and count for nothing. /nerotrophies gallery clear restores the area exactly, even after a restart.
  • A "Hall of Fame" NeroQuests chapter, shipped as data (used only when NeroQuests is installed).
  • Commands: /nerotrophies list, announce on|off, showname on|off, export, gallery, gallery clear; operator list <player>, award, revoke, reload; admin export <player>.
  • Config: announceTiers, reclaimCooldownSeconds, retroPlayersPerTick, retroChecksPerTick, retroMillisPerTick, pollIntervalTicks, rewardsEnabled, coinsBronze|Silver|Gold|Nero.
  • Tools: a trophy-data validator, an asset checker and a wiki catalogue generator, all run in CI; generators for textures, models, sounds and particles.

Fixed (pre-release review)

  • Old progress never pays or announces. Until a player's retroactive pass for the session has finished (after login, a datapack reload, a definition change or /nerotrophies reload), every trophy a live trigger finds for them is recorded as retroactive: no coins, no announcement, no push, counted in the login summary. Previously a dimension check or periodic statistics visit inside the 40-tick login delay could award old progress as live.
  • Erase and rejoin cannot farm coins. A player whose record is erased while online is awarded nothing more that session; at their next login the progress the game still holds comes back as retroactive, without coins.
  • Erasure always cleans the quarantine. The store's backup is refreshed, and any quarantined .corrupt copy of a damaged store deleted, even when the live store has no record for the player.
  • Large exports work. /nerotrophies export splits the JSON into chunks of at most 32 KiB measured as the text travels (UTF-8, NBT's modified UTF-8 and escaped JSON), safely below the 65,535-byte limit of a click-to-copy value; multibyte names and very large records no longer break the export.
  • Gold trophies can't be handed over. Half a Million and Orbital Power now need the item crafted, not just held, and Void Harvest is silver. The validator rejects item_obtained above silver.
  • Bounded record packets. The Book's record payload stays under 768 KiB and the collection list sent with every award under 192 KiB, so a pack at Core's definition limits gets a truncated Book instead of a multi-megabyte packet.
  • Cheaper name sync. Each player's visible-set pass looks only at the chunks within view instead of every loaded display on the server.

Known limitations

  • With rewardsEnabled on, a trophy that can be triggered live again (re-entering a dimension, re-crossing a currency or reputation value, re-opening an erased player gate) pays again after the player erases their record, because erasure removes the record of what was paid.
  • /nerotrophies revoke does not stick while the player still meets the trophy's trigger: it can be awarded again.
  • Creative mode can copy a trophy with its stamp; the copy shows the same earner.
  • Trophies for milestones that a mod doesn't report per player yet are not shipped (see "Catalogue scope"). Threshold events and progression gates that only open for a recorded machine owner are not used.
  • Dyeing a pedestal or cabinet works on a plain right-click (vanilla skips sneak-use while an item is held).
  • A renamed trophy item loses its custom name when placed.
  • The toast's gold and nero sheen always plays; there is no reduced-motion option yet.
  • The gallery is capped at 96 blocks long.

Privacy

  • One store (trophy_state) holds everything NeroTrophies knows about a player: UUID, earned trophy ids and award times, claim tokens, completed collections and trims, which rewards were paid, the last-known gamertag and the announce / showname toggles. Trophy items, blocks, cabinets and chunks hold a trophy id and a token only.
  • Erasure through Neroland Core (/neroland data eraseme or an operator's erase) removes the whole record and its tokens, refreshes the store's backup at once, tells every connected player to forget the name in the same tick and fires TrophyEvents.RecordErased. Every copy of that player's trophies then shows no name, wherever it is.
  • Core's dataRetentionDays erases the records of players inactive for longer, through the same eraser.
  • /nerotrophies export sends your own record to your chat as click-to-copy JSON, never to a file or the log. It now also lists coin rewards paid for trophies that were revoked later.
  • /nerotrophies showname off hides your name on all your trophies and from announcements without erasing anything.
  • Logs carry counts and trophy ids only; crash reports carry no personal data and stay opt-out.
  • Verified by a server game test on Fabric 26.3 (:fabric:26.3:runGameTest): real block-entity, item, player and chunk data hold no UUID or name, and after erasure no store file on disk (primary, backup or quarantine) does.

Catalogue scope

  • The catalogue aims for at least six trophies per Neroland mod. A few ship fewer for now: NeroLink 0, NeroQuests 3, NeroMaps 4, NeroArcade 5 and NeroNotes 5. More arrive when those mods expose the events.
Full changelog →

在所有 Nero 模组百科中搜索。百科内容目前为英文。