Treasure Hunt

TREASURE MAP FRAGMENTS

Turn exploration and combat into real treasure hunts.

Treasure Map Fragments adds a complete treasure-hunting system to Hytale. Defeat enemies, collect map fragments based on their difficulty, rebuild treasure maps, follow their directions and find hidden chests containing tier-appropriate loot.

Four treasure tiers, timed hunts, optional treasure guardians, configurable loot condition, safe chest placement and terrain restoration are all included.

HOW IT WORKS

Enemies have a chance to drop a treasure map fragment when defeated.

The fragment tier depends on the difficulty of the enemy:

Tier 1: White fragment
Tier 2: Green fragment
Tier 3: Blue fragment
Tier 4: Purple fragment

Higher-tier enemies therefore give access to higher-tier treasure hunts.

The fragment drop chance is configurable by the server administrator. The default value is 17%.

ASSEMBLING A TREASURE MAP

Collect six fragments of the same tier.

Once you have six matching fragments, hold the stack in your hand and right-click.

The mod searches for a safe treasure location around the player. If a valid location cannot be found, the six fragments are kept and no map is created.

If a suitable location is found, the six fragments are replaced by a treasure map of the corresponding tier and a treasure chest is generated in the world.

Each player can have only one active treasure hunt at a time. The current hunt must be completed before another map can be assembled.

SAFE TREASURE PLACEMENT

Treasure Map Fragments performs several checks before creating a treasure chest.

The mod searches for suitable terrain, checks the surrounding area and avoids unsafe situations involving fluids or unsuitable locations.

A map cannot be assembled while the player is more than 15 blocks below the surface. The player must return closer to the surface before starting a treasure hunt.

If no safe location can be found, the fragments are not consumed.

FINDING THE TREASURE

Each completed map is linked to one specific treasure chest.

Right-click the treasure map to display its directional interface for three seconds.

The interface shows the direction of the chest relative to the player and helps guide the player toward the treasure.

The map shows the eight main directions.

The map also indicates when the player has reached the treasure location.

TIMED TREASURE HUNTS

Treasure hunts are time-limited.

As soon as a treasure map is successfully created, a countdown begins.

By default, the player has 10 minutes to find and open the treasure chest.

The administrator can configure the allowed hunt duration between 1 and 60 minutes through the administration panel.

If the time expires before the chest is reached, the treasure disappears and the associated map becomes invalid.

TREASURE LOOT

The contents of the chest depend on the tier of the treasure map.

Higher-tier maps provide access to higher-tier rewards.

The loot system can include weapons, tools, armor, materials and other suitable items.

Treasure Map Fragments also detects craftable equipment available through the active content packs, allowing treasure loot to integrate with the content installed on the server instead of relying only on a fixed internal item list.

EQUIPMENT CONDITION

Weapons, tools and armor found inside treasure chests can have a configurable remaining condition.

The administrator defines both a minimum and maximum condition between 1% and 100%.

For example, setting the minimum condition to 40% and the maximum condition to 80% allows treasure equipment to appear with a random remaining condition within that range.

Setting both values to 100% makes all generated equipment appear in new condition.

TREASURE GUARDIANS

Treasure guardians are optional and can be enabled or disabled by the administrator.

When enabled, a hostile NPC is generated near the treasure chest.

The guardian selection takes the treasure tier into account, allowing more valuable treasure hunts to be associated with more appropriate enemies.

This feature relies on Hytale's native NPC system.

PROTECTED TREASURE CHESTS

Active treasure chests are protected against normal destruction.

Players cannot simply break the chest to bypass the treasure-hunt system.

Creative mode retains the ability to remove a treasure chest when administrative intervention or testing is required.

OPENING AND CLOSING THE CHEST

Finding the chest is not the final step.

The player opens the treasure chest and takes the rewards they want.

Once the chest is closed, the treasure hunt ends.

The chest disappears along with any loot left inside it, and the treasure map linked to that chest is removed.

The player then receives a warning and has a short amount of time to move away before the terrain is restored.

SAFE TERRAIN RESTORATION

Treasure Map Fragments includes a terrain restoration system designed to avoid damaging caves and nearby structures.

When a treasure location is created, the mod records the original state of the 7 × 7 × 7 area surrounding the chest.

After the chest is closed and the configurable restoration delay expires, the mod restores only original blocks that were removed.

Natural empty spaces remain empty.

A cave entrance that already existed before the treasure hunt will therefore remain open.

Blocks placed afterward are not blindly replaced.

The restoration system also restores the original block type instead of filling the entire area with generic stone.

If the required terrain snapshot is no longer available, the mod avoids generating an arbitrary block volume that could accidentally seal a cave or damage the surroundings.

ADMINISTRATION PANEL

All main server settings are available through one administration interface.

Enter:

/th admin

The panel allows administrators to configure the treasure hunt duration, treasure chest distance, fragment drop chance, terrain restoration delay, minimum equipment condition, maximum equipment condition and treasure guardian activation.

It also includes a button that allows an administrator to teleport to the currently active treasure chest.

Settings are saved immediately when changed.

DEFAULT SETTINGS

Treasure hunt duration: 10 minutes

Treasure distance: 5 blocks

Fragment drop chance: 17%

Terrain restoration delay: 60 seconds

Minimum equipment condition: 100%

Maximum equipment condition: 100%

Treasure guardian: Disabled

TREASURE TIERS

Treasure Map Fragments contains four complete fragment and map tiers.

Tier 1 uses white fragments and a white treasure map.

Tier 2 uses green fragments and a green treasure map.

Tier 3 uses blue fragments and a blue treasure map.

Tier 4 uses purple fragments and a purple treasure map.

Six fragments of the same tier are required to create the corresponding treasure map.

MULTIPLAYER AND SERVER USE

The treasure system tracks hunts individually.

Each player can have one active treasure map and linked treasure chest at a time.

Administrative settings are shared by the server and allow server owners to adjust treasure hunts to suit progression speed, world size and desired reward frequency.

LANGUAGES

Treasure Map Fragments currently includes English and French localization.

INSTALLATION

Place the TreasureMapFragments JAR file in the appropriate Hytale server or world mods folder.

Start or restart the server.

Administrators can then configure the mod in-game with:

/th admin

REQUIREMENTS

Treasure Map Fragments includes its own asset pack.

The mod uses the native Hytale AssetModule and NPC systems.

No additional third-party mod dependency is declared.

COMPATIBILITY

Mod version: 0.2.52

Declared Hytale server compatibility: ^0.5.0

Author: Agonos with Chatgpt

MAIN FEATURES

Four map fragment and treasure tiers.

Six matching fragments required to assemble a map.

Enemy difficulty determines fragment tier.

Configurable fragment drop chance.

Safe treasure location search.

Directional treasure map interface.

Timed treasure hunts.

Tier-based treasure loot.

Support for craftable equipment from active content packs.

Configurable equipment condition.

Optional treasure guardians.

Protected treasure chests.

Automatic map removal when a hunt ends.

Configurable terrain restoration delay.

Safe restoration of excavated terrain.

Natural caves and pre-existing empty spaces remain open.

Single administration interface through /th admin.

Administrator teleport button for the active treasure chest.

English and French localization.