Thorn

GitHub || API Docs

Customize to your ❤️'s content

Freely draggable HUD elements. Key input overlay. Wireframe-style weapons & enemies

Gameplay modifiers

Submerged. Force-radiance. Enemy multiplication. Floor is Lava.

A comfy config system

• Bring it up with a keybind (RightShift by default)
• Has a modern NocturnalOS style, yet familiar UI to Minecraft client users
• Can be used for any mod, like PluginConfig and Configgy. See the Wiki.

It's extensible

For developers, there's the wiki available. Classes and methods are also XML-documented.

Fair play statement

Thorn disables leaderboard submissions for built-in modules that alter the gameplay mechanics, and also offers a module to disable leaderboards voluntarily.

While the system allows modules to self-declare cheatiness, this does not prevent extensions from making violations. Cheating is not a technical problem and cannot be solved technically.

Copyleft

Thorn's code is released under the LGPL-3.0 license, which means you are free to use its config system in your mod, whether or not it's open source; modifications to Thorn itself however are required to be open-sourced under the same terms.

Assets are released under the CC BY-SA 4.0 license. This means you are free to reuse them as long as you give attribution and maintain the same license for derivative works.

Technical description

Thorn as a whole is an utility mod, with its own config system featuring a compact UI to house its 50+ modules. This package contains those modules.

Acknowledgements

• Thank you eternalUnion for showing how to handle keybind listening and other configuration-related stuff in PluginConfigurator
• Thank you wafflethings for inspiration and many implementation details from UltraTweaker

0.5.1: description edit on thunderstore (i typed "utility" wrong lol)

0.5.0

Thorn has been split into two packages. This release note is the same for both, but for later versions changes will be listed in their own packages.

• Packaging: Splitted Thorn's config system and the built-in modules into separate packages: Thorn and Thorn Core. The former contains the modules and the latter contains the config system.
  • Regular users: no action is required if you use a mod manager. Otherwise get the Thorn Core package.
  • Mod developers utilizing the config system: it's recommended to declare Thorn Core instead of Thorn as the dependency. This gives your users a clean version of Thorn without the modules, in case they don't want them. No code change is required.
  • Also made the package structure more manual install-friendly, although we recommend against this.
• Added FolderPath and FilePath config data types
• New modules:
  • Custom Style Ranks (with a very fancy image picker)
  • HUD: Weapon cooldowns: revolver coins, revolver blue charge, revolver red charge, jackhammer core, shotty/hammer saw, blue nails, blue saws, blue magnets, overheat nails, overheat saws, jumpstart cable, freezeframe juice, firestarter oil, srs cannonball
• Made bounded value HUD modules more readable by default
• Made the ClickGUI windows not go back to their previous position after dragging
• Enemy tracers: fixed threshold being off by 1, added enemy type blacklist
• Fixed custom style ranks (from Ultraskins or whatever) being oversized
• Made HUD widget snapping on the sides slightly more consistent
• Fixed duplicate cheatiness notifications
• Edges (Enemies): Added indication for sanded and made deathcatched enemies follow puppet's color
• Made gun HUD widget empty by default instead of having a black saw hammer
• Made stamina and railcannon charge HUD modules display both live charging and readily usable values

0.4.0

• Added EnhancedColor data type. Most customizable colors can now have rainbow pulse
• New modules: Visible Portals, Extra Binds, Gravity Tweak
• New HUD widgets: Custom Label
• Added foreground (text/icon) color customization to stat HUD elements
• Fixed Railcannon charge meter jumping from 80% to full
• Viewmodel Tweaks: Edges skin: made it work with spawner arms and fixed applied to Piercer's charge effect/panel
• Weapon Variant Binds: added spawner arms
• ClickGUI: Raised the layer so the tabs are clickable when Polarite is installed and spawns a blocking notification panel; made Back navigation (Esc/Mouse4) on ClickGUI pop panels before going to previous layer

0.3.0

• Added snapping for HUD widgets
• Added support for custom setting UI elements
• New HUD modules: Alerts, Freshness, Style Multiplier, Style Feed, Style Rank, Style Points (of current rank)
• Added an option for Run In Background to only affect menus (useful for large Angry downloads)
• Fixed Freezeframe rocket ride hints flipped when doing 8-2 challenge

0.2.0

• Added config profiles
• New modules: Boss Bars
• New HUD modules: Rocket Fuel, Clock
• Fixed Weapon Variant Binds not working during hitstops
• Bounded value indicators:
  • Added vertical line and crosshair circle style
  • Made horizontal progress bar HUD elements have customizable length and can have icon/numbers hidden. You can now have clean horizontal crosshair indicators!
• Tweaked some icons for consistency & readability

0.1.4

• New modules: Force Enrage, Resize Enemies, Edges (World)
• Made viewmodel tweaks edges work with arms
• Added 12h/24h option for ClickGUI top bar clock
• Fixed hasToggling constructor param for Modules not working
• Fixed tooltip positioning that made buttons unclickable in certain cases
• Fixed very inconsistent icon colorizing
• Fixed dropdown texts being empty

0.1.3

• Added FixPluginTypesSerialization dependency (basically makes dependent mods like Billion Nemesis load properly without Angry already installed)
• Fixed weird bounded value hud module style selection
• Use a new menu for big enums (tmp dropdown sucks)
• Prevent setting group buttons from spawning many children window
• Made HUD elements scalable
• UI: Only colorize monochrome icons, underline active modules

0.1.2

• ClickGUI: prevented cheat binds and esc pause from triggering
• Fixed battery icon error spam for desktop users without a battery
• Added UI hint for enum substitutions
• Fixed a bug where you could move the drag area of a disabled HUD module's config window

0.1.1 omitted because it was used for a description edit on Thunderstore

0.1.0

• Initial release