AdventureSystems

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.

Key Features

• 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.

Dependencies

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

Access and Configuration

• 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.

Detailed Feature Reference

Curios, Wallet & Shop

Overview

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.

Key Features

• 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.

Configuration

config/kineticcore/curios.toml
config/kineticcore/currency_wallet_shop.toml
config/kineticcore/currency_wallet_shop_client.toml

Feature Reference

Config Details

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 and HUD

Item	Description
Gourmet's Law (Infinite Growth):	Devour various foods to permanently gain final damage bonus.

Editable Options

• Balance Overlay
• Module Toggles
• Heart of Steel
• Paradise Lost
• Currency Wallet

Config Defaults

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

Data Paths

Primary configuration/data paths:

• config/kineticcore/curios.toml
• config/kineticcore/currency_wallet_shop.toml
• config/kineticcore/currency_wallet_shop_client.toml

FTB Quests Integration

Overview

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.

Key Features

• Quest-jump tooltip for bound items.
• G opens the default linked quest.
• Alt + G opens 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.

Configuration

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

Feature Reference

Config Details

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.

GUI and Editors

Item	Description
submit	Enter how many exchanges to submit.

Item and HUD

Item	Description
Favorite Quest	Right-click to set this task as the default open target
Search Quest	Search quests linked to the current item.

Editable Options

• [Mod Global]
• [Item Tag]

Config Defaults

Key	Default
enableTaskJump	true

Data Paths

Primary configuration/data paths:

• config/kineticcore/ftb_item_blacklist.json
• config/kineticcore/ftb_item_client.toml
• config/kineticcore/ftb_item_quest_bindings.json
• config/kineticcore/ftb_quest_favorites.json

Contextual Tips

Overview

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.

Main Features

Multi-Stage Tips

Each tip can target:

• loading
• game
• any

Each entry also has its own display duration.

Context Conditions

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.

NBT Matching

Item-based conditions support:

• NONE: item type only
• WEAK: weak NBT matching
• STRONG: strict NBT matching

This is useful for quest items, custom equipment, guns, accessories, and other NBT-heavy items.

Per-Language Tip Files

Typical files include:

• tips_zh_cn.json
• tips_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.

Visual Editor

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.

Server Sync

• 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.

Configuration

Base settings:

• config/kineticcore/tips_settings.toml

Tip directory:

• config/kineticcore/tips/

Typical language files:

• config/kineticcore/tips/tips_zh_cn.json
• config/kineticcore/tips/tips_en_us.json

Feature Reference

Config Details

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.

GUI and Editors

Item	Description
[Tip]	Enter seconds (e.g., 5.0)

Config Defaults

Key	Default
enableTips	true

Data Paths

Primary configuration/data paths:

• config/kineticcore/tips
• config/kineticcore/tips/
• config/kineticcore/tips/tips_en_us.json
• config/kineticcore/tips/tips_zh_cn.json
• config/kineticcore/tips_settings.toml

Building from Source

• Minecraft: 1.20.1
• Java: 17
• ForgeGradle: 6.0.24
• Gradle: the project is pinned to the 8.1.1 Wrapper; do not import it with Gradle 9 directly.
• Local development JARs are controlled by local_libs_dir and can be overridden in gradle.properties or with a project property.
• Typical build command: gradlew.bat build on Windows or ./gradlew build on Linux/macOS.
• Development and release artifacts use adventuresystems as the current project identifier.