Relics Debugger

A developer and packmaker diagnostic suite for the Relics mod and Curios API ecosystem on NeoForge 1.21.1.

Whether you are designing a modpack, developing custom Relics addons, balancing progression curves, or troubleshooting ability mechanics, Relics Debugger provides real-time telemetry, inventory scanning, live data inspection, and an interactive 3D visual inspector screen.

Features at a Glance

• Universal Relic Telemetry: Intercepts and monitors core Relics API events (RelicExperienceChangeEvent, RelicLevelChangeEvent) in real time across base Relics and all third-party addon mods.
• Interactive 3D Inspector GUI: Press [K] to open the developer dashboard featuring 3D item rendering, leveling progression curves, ability constellations, and live NBT data views.
• Curios & Inventory Scanning: Scan bearers, inspect active Curios accessory slots, and identify equipped relics across players with pinpoint accuracy.
• Live Attribute & Level Tweaking: Modify experience points, set levels, adjust ranks, award ability points, or reset relic states directly via in-game commands or GUI buttons.
• Granular Notification Toggles: Independently enable or mute chat notifications, server console broadcasts, desync alerts, milestone pings, and event logs.
• Zero Overhead: Fully event-driven design that stays dormant until triggered, ensuring zero performance penalty on servers or clients.

The Relic Inspector GUI

Press [K] (configurable in Controls) while holding or wearing a relic to open the Relic Inspector:

• 3D Viewport: Real-time rendering of the selected relic item.
• Abilities & Constellations: Visualizes ability star nodes, unlocked tiers, and active ability templates.
• Live Stat Readout: Inspect base values, current multipliers, and active cooldown states.
• Developer Quick Actions: Buttons to add XP, level up, award leveling points, cycle ability modes, or reset data instantly.
• Curios Matrix: Live overview of all equipped Curios slots with one-click slot inspection.

In-Game Commands

Base command: /relicsdebugger (Aliases: /relicdebug, /rdebug)

Inspection & Diagnostics

• /relicsdebugger status – Displays current tracking modes, active listeners, and logging configuration.
• /relicsdebugger gui – Prompts and opens the Relic Inspector GUI.
• /relicsdebugger inspect hand – Dumps complete data, stats, and leveling info for the item in your main hand.
• /relicsdebugger inspect offhand – Inspects the offhand item.
• /relicsdebugger inspect curios <slot> – Inspects the relic equipped in a specific Curios slot.
• /relicsdebugger scan [player] – Scans the target player’s inventory and Curios slots, listing all equipped relics.

Progression & Testing (Requires Permission Level 2)

• /relicsdebugger addxp <amount> [ability] [source] – Grants relic experience to the held item.
• /relicsdebugger setlevel <level> – Sets the relic level directly.
• /relicsdebugger addlevel <delta> – Adds or subtracts levels.
• /relicsdebugger setrank <rank> – Adjusts the relic rank.
• /relicsdebugger setpoints <points> – Sets available leveling ability points.
• /relicsdebugger cyclemode <ability> – Cycles the active mode of a multi-mode ability.
• /relicsdebugger reset – Resets the relic back to its baseline default data.
• /relicsdebugger clearstats – Clears recorded debug statistics.

Event & Output Toggles (Requires Permission Level 2)

• /relicsdebugger toggle <option> – Toggles individual notification channels:
• chat – In-game player chat messages.
• broadcast – Server-wide broadcast notifications.
• log – Console and server log file output.
• xp – Real-time experience gain alerts.
• levels – Level-up and rank change notifications.
• points – Ability points allocation alerts.
• modes – Ability mode toggle events.
• curios – Curios equip and unequip tracking.
• milestones – Max level and research milestone alerts.
• desync – Client/server state desync detection.
• all – Master toggle for all notifications.

Controls & Keybinds

Configuration

Settings are saved in config/relics_debugger-common.toml and synchronize across server and client:

• Default notification states (chat, console, broadcast).
• Telemetry filters and verbosity thresholds.
• Curios integration hooks and sync intervals.

Requirements

• Minecraft: 1.21.1
• NeoForge: 21.1.235 or higher
• Java: 21
• Relics: 0.12.0 or higher
• Curios API: Compatible and supported

Author & Credits

• Developed by eldodoron
• Special thanks to SSKirillSS for the Relics mod and its extensible API.