AdventureSystems
- By
A player-progression and adventure utility suite centered on Curios equipment, wallet/currency and shop mechanics, FTB Quests navigation and submission helpers, and context-sensitive tutorial or story tips.
The project is designed around in-game administration. Where a feature changes shared gameplay data or server rules, the server remains authoritative; client-only presentation features stay local to the client. Configuration screens use KineticCore's UI and configuration infrastructure.
- Curios equipment utilities and configurable accessory behaviors.
- Wallet, currency and shop systems with server-authoritative rules.
- FTB Quests item/tag/NBT bindings, quick navigation and repeated submission helpers.
- Contextual tips filtered by dimension, biome, structure, advancement, inventory and Curios equipment.
- Language-aware tip data and in-game visual editing.
- Optional integrations with Refined Storage, Sophisticated Backpacks and JEI.
| Type | Dependency |
|---|---|
| Required | Forge 47.4.0+ |
| Required | KineticCore 26.9.8+ |
| Required | Curios 5.10+ |
| Required | FTB Library |
| Required | FTB Quests |
| Required | FTB Teams |
| Optional | Refined Storage |
| Optional | Sophisticated Backpacks |
| Optional | JEI |
- Open the KineticCore configuration center with its configured F6 entry and select Adventure Systems.
- Server-owned settings are saved by the server and synchronized where the feature requires client awareness.
- Client-only presentation settings remain local.
- Individual feature areas document their own data/configuration paths below.
- Search, list selection, item/entity inspection, tooltips and return/navigation controls reuse KineticCore UI components where available.
Curios and Wallet Systems is an accessory, wallet, and wallet-shop mod. It provides configurable accessory mechanics, currency storage and exchange, shop transactions, and optional integrations with quests, villager trading, Sophisticated Backpacks, and Refined Storage.
- Currency wallet with deposit, withdrawal, exchange, magnet pickup and HUD.
- Protected/manual-only currencies.
- Configurable wallet shop with buy/sell entries, limits, quest requirements and weighted reward pools.
- Material consumption from player inventory, Sophisticated Backpacks and bound Refined Storage networks.
- Heart of Steel accessory with combat stacking and configurable health/damage behavior.
- Paradise Lost accessory with food-variety based mechanics.
- Levitation Backpack accessory and knockback-related behavior.
- Curios slot/conflict handling and tooltip integration.
config/kineticcore/curios.toml
config/kineticcore/currency_wallet_shop.toml
config/kineticcore/currency_wallet_shop_client.toml
| Item | Description |
|---|---|
| Wallet HUD | Adjust the wallet balance overlay for this client. Changes apply immediately and do not modify server settings. |
| Edit Position and Scale | Opens a live preview editor. Drag the overlay to move it, scroll while hovering to scale it, or use arrow keys for precise movement. |
| Curio and Wallet Mechanics | Server-authoritative accessory mechanics and currency rules. Both singleplayer and multiplayer read and save through the active server; editing requires permission level 2. |
| Wallet Shop Editor | Edit the wallet shop through a server snapshot. Remote editing requires permission level 2, and the server validates and saves every change. |
| Open Shop Editor | Requests the shop snapshot from the current server and enters edit mode directly. No equipped wallet is required; the server rejects insufficient permissions. |
| Enable Heart of Steel | Controls whether Heart of Steel is registered as a functional accessory. A game or server restart is required. |
| Enable Paradise Lost | Controls whether Paradise Lost is registered as a functional accessory. A game or server restart is required. |
| Enable Levitation Backpack | Controls whether the Levitation Backpack is registered as a functional accessory. A game or server restart is required. |
| Enable Currency Wallet | Controls whether the Currency Wallet and its currency features are enabled. A game or server restart is required. |
| Charge Cooldown (Seconds) | Cooldown after a charged attack successfully grants stacks. Default: 3 seconds. |
| Bonus Damage Cap | Absolute cap on final bonus damage converted from maximum health. Default: 3. |
| Stacked Health Cap | Maximum bonus health obtainable from stacks, excluding the base health bonus. Default: 200. |
| Stacks per Health Point | Number of stacks converted into 1 maximum health point. Must be at least 1. Default: 100. |
| Base Health Bonus | Maximum health granted immediately while Heart of Steel is equipped, without stacks. Default: 10. |
| Healing Multiplier | Base multiplier used when a charged attack heals from damage dealt. Default: 2. |
| Damage Window (Ticks) | Duration during which bonus damage can apply after charging. 20 ticks equal 1 second. Default: 5 ticks. |
| Minimum Stacks per Hit | Minimum random stacks from one successful charged attack. It should not exceed the maximum. Default: 2. |
| Maximum Stacks per Hit | Maximum random stacks from one successful charged attack. It should not be below the minimum. Default: 5. |
| Damage Coefficient per Health | Ratio of maximum health converted to bonus damage. 0.005 means 0.5%, still limited by the damage cap. |
| Conflicting Accessory IDs | Heart of Steel is disabled while any listed accessory is equipped. Enter one full item ID per line, such as enigmaticlegacy:cursed_ring. |
| Minimum Nutrition | Foods with nutrition at or below this value do not count toward variety. A value of 0 ignores foods that restore no hunger. |
| Conflicting Accessory IDs | Paradise Lost is disabled while any listed accessory is equipped. Enter one full item ID per line. |
| Extra Belt Slots | Additional Curios belt slots granted while the wallet is equipped. Re-equipping may be required after a change. |
| Maximum Currency Types | Maximum currency types read by the UI and currency system. The runtime hard cap is 10. |
| Currency Magnet Radius | Radius in blocks for collecting currency drops while the wallet is equipped. Values at or below 0 disable the magnet. |
| Magnet Check Interval (Ticks) | Interval between nearby-currency scans. Higher values reduce server work but increase pickup delay; 20 ticks equal 1 second. |
| Currency Definitions | One item_id|base_value entry per line; value must be positive. Example: kubejs:gold_coin|1. |
| One-Way Exchange Rules | One source_item_id->target_item_id entry per line for change-making and upgrades. Add the reverse direction separately when needed. |
| Manual-Exchange-Only Currencies | These currencies are never auto-consumed or split by villager trades, the wallet shop, or FTB virtual payments. Enter one item ID per line. |
| Item | Description |
|---|---|
| Gourmet's Law (Infinite Growth): | Devour various foods to permanently gain final damage bonus. |
- Balance Overlay
- Module Toggles
- Heart of Steel
- Paradise Lost
- Currency Wallet
| Key | Default |
|---|---|
currency_wallet.extraBeltSlots |
1 |
currency_wallet.hudOffsetX |
0 |
currency_wallet.hudOffsetY |
0 |
currency_wallet.hudScale |
0.75 |
currency_wallet.magnetIntervalTicks |
10 |
currency_wallet.magnetRange |
6.0 |
currency_wallet.maxCurrencyTypes |
10 |
general.enable_currency_wallet |
true |
general.enable_heart_of_steel |
true |
general.enable_levitation_backpack |
true |
general.enable_paradise_lost |
true |
heart_of_steel.baseHealth |
10.0 |
heart_of_steel.damageCap |
3.0 |
heart_of_steel.damagePerHp |
0.005 |
heart_of_steel.damageWindowTicks |
5 |
heart_of_steel.growthInterval |
3 |
heart_of_steel.healMultiplier |
2.0 |
heart_of_steel.maxGain |
5 |
heart_of_steel.maxHealthCap |
200 |
heart_of_steel.minGain |
2 |
heart_of_steel.stacksPerHp |
100 |
paradise_lost.minNutrition |
0 |
Primary configuration/data paths:
config/kineticcore/curios.tomlconfig/kineticcore/currency_wallet_shop.tomlconfig/kineticcore/currency_wallet_shop_client.toml
FTB Quests Integration integrates with FTB Quests. It binds items, item tags and NBT variants to quest pages, provides direct quest navigation from item tooltips, and improves repeated submission for supported FTB item tasks.
- Quest-jump tooltip for bound items.
Gopens the default linked quest.Alt + Gopens the multi-quest selector.- Per-item favorite/default quest selection.
- Item, tag and fuzzy-NBT binding rules.
- Item/tag/NBT blacklist support.
- Visual binding editor in the F6 configuration center.
- Multi-submit support for eligible repeatable FTB ItemTasks.
- Server-side task submission remains authoritative.
- Local client switch for tooltip and hotkey navigation.
- Optional JEI integration.
config/kineticcore/ftb_item_client.toml
config/kineticcore/ftb_item_quest_bindings.json
config/kineticcore/ftb_quest_favorites.json
config/kineticcore/ftb_item_blacklist.json
| Item | Description |
|---|---|
| Enable Quest Task Jump | Shows quest-task links and enables the task jump shortcut for matching items. |
| Open Item Binding Editor | Edit FTB task item bindings, favorites, and blacklist entries. |
| Item | Description |
|---|---|
| submit | Enter how many exchanges to submit. |
| Item | Description |
|---|---|
| Favorite Quest | Right-click to set this task as the default open target |
| Search Quest | Search quests linked to the current item. |
- [Mod Global]
- [Item Tag]
| Key | Default |
|---|---|
enableTaskJump |
true |
Primary configuration/data paths:
config/kineticcore/ftb_item_blacklist.jsonconfig/kineticcore/ftb_item_client.tomlconfig/kineticcore/ftb_item_quest_bindings.jsonconfig/kineticcore/ftb_quest_favorites.json
Contextual Tips is a contextual tip system for modpacks, servers, tutorials, and story-driven gameplay. Tips can appear during loading, in-game, or in any stage, and can be filtered by the player's current dimension, biome, structure, advancements, inventory items, and Curios equipment.
Tip data is server-authoritative and language-aware. Administrators can maintain it through an in-game visual editor instead of manually editing complex JSON.
Each tip can target:
loadinggameany
Each entry also has its own display duration.
Tips may require one or more of the following:
- Dimension
- Biome
- Structure
- Advancement
- Inventory item
- Curios item
Only tips whose conditions match the current player are eligible for display.
Item-based conditions support:
NONE: item type onlyWEAK: weak NBT matchingSTRONG: strict NBT matching
This is useful for quest items, custom equipment, guns, accessories, and other NBT-heavy items.
Typical files include:
tips_zh_cn.jsontips_en_us.json
Clients report their selected language and the server sends the matching runtime tip snapshot. English is used as a fallback when the requested language file is unavailable.
Administrators can:
- Add, edit, delete, and search tips.
- Edit formatted text with Minecraft
§formatting codes. - Set stage and duration.
- Select dimension, biome, structure, and advancement conditions.
- Add inventory-item and Curios requirements through selectors.
- Cycle NBT match modes.
- Remove conditions with right-click actions.
The server validates resource IDs, text length, NBT syntax, duration limits, and entry counts before accepting data.
- Tip data is loaded from the server.
- Editing requires administrator permission.
- The server validates every save request again.
- Updated language JSON is written server-side.
- Large JSON payloads use KineticCore's compressed network transport with size limits.
- Updated snapshots are broadcast only to clients using the relevant language.
- Integrated singleplayer servers use the same save path.
Base settings:
config/kineticcore/tips_settings.toml
Tip directory:
config/kineticcore/tips/
Typical language files:
config/kineticcore/tips/tips_zh_cn.jsonconfig/kineticcore/tips/tips_en_us.json
| Item | Description |
|---|---|
| Screen Tip Settings | Controls custom tips on loading, world-transition, and pause screens. Edit the basic toggle here and use the dedicated editor for tip content and conditions. |
| Enable Screen Tips | Disabling this hides custom loading, world-transition, and pause tips without deleting tip data. |
| Open Tip Editor | Edit tip text, stage, duration, biome/structure/dimension/advancement conditions, and item/Curios NBT conditions. Opening the editor on a multiplayer server requires permission level 2. |
| Item | Description |
|---|---|
| [Tip] | Enter seconds (e.g., 5.0) |
| Key | Default |
|---|---|
enableTips |
true |
Primary configuration/data paths:
config/kineticcore/tipsconfig/kineticcore/tips/config/kineticcore/tips/tips_en_us.jsonconfig/kineticcore/tips/tips_zh_cn.jsonconfig/kineticcore/tips_settings.toml
- Minecraft:
1.20.1 - Java:
17 - ForgeGradle:
6.0.24 - Gradle: the project is pinned to the
8.1.1Wrapper; do not import it with Gradle 9 directly. - Local development JARs are controlled by
local_libs_dirand can be overridden ingradle.propertiesor with a project property. - Typical build command:
gradlew.bat buildon Windows or./gradlew buildon Linux/macOS. - Development and release artifacts use
adventuresystemsas the current project identifier.
The AdventureSystems Team
