CrossbowSaveArrow

Per-crossbow ammo storage for Hytale. Each crossbow remembers its loaded arrows independently.

⚠️ IMPORTANT: This is NOT a regular mod! This is an Early Plugin (Hyxin/Mixin mod). It will NOT work if placed in the Mods folder. The CurseForge app does not install it correctly — you must install it manually. See the Installation section below.

The Problem

In vanilla Hytale, arrows are lost when you switch away from a crossbow. If you loaded 4 arrows and switch to a sword, those arrows vanish. This mod fixes that.

Features

• Arrows persist on weapon switch — the main feature! No more losing loaded ammo when switching weapons
• Individual ammo tracking — each crossbow stores its own arrow count in item metadata
• Persistent storage — ammo is saved when you:
  • Switch to another weapon
  • Drop the crossbow
  • Store it in a chest
  • Trade with other players
• No arrow duplication — arrows that would normally return to inventory on weapon switch are blocked
• Multiplayer compatible — works correctly when other players pick up your crossbows

Technical Details

This mod uses an event-based architecture with Mixin injection rather than tick-based systems. This means:

• Zero performance overhead during normal gameplay
• Code only executes when weapon stats are recalculated (on weapon switch)
• No continuous polling or per-tick checks

Requirements

• Hyxin — Mixin loader for Hytale
  • CurseForge
  • GitHub

Installation

⚠️ The CurseForge app only installs mods into the Mods folder. This mod is an Early Plugin and must be installed manually into the earlyplugins folder.

Single Player / Client-Hosted Server

1. Download Hyxin.jar and place it in:

   UserData/EarlyPlugins/

1. Download CrossbowSaveArrow-*.*.*.jar and place it in your world save folder:

   UserData/Saves/<YourWorldName>/earlyplugins/

(Create the earlyplugins folder if it doesn't exist)

1. Launch the game and load the world

Linux users: The folder must be named exactly earlyplugins (lowercase). Linux is case-sensitive, so EarlyPlugins won't work.

Dedicated Server

1. Download Hyxin.jar and place it in:

   <ServerRoot>/earlyplugins/

1. Download CrossbowSaveArrow-*.*.*.jar and place it in the same folder:

   <ServerRoot>/earlyplugins/

1. Add --accept-early-plugins to your server launch command. Example:

   java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets ../Assets.zip --accept-early-plugins

1. Start the server. You should see it loading mods from the earlyplugins folder in the console.

Linux users: The folder must be named exactly earlyplugins (lowercase). Linux is case-sensitive.

How It Works

When you switch away from a crossbow, the current ammo count is saved to the crossbow's item metadata. When you switch back (or pick up a crossbow from the ground), the ammo is restored from metadata.

This allows you to have multiple crossbows with different ammo counts — perfect for combat loadouts where you want pre-loaded crossbows ready to fire.

Compatibility

• Works with vanilla crossbows and any modded crossbows that use the standard ammo stat system
• Compatible with other mods that don't modify crossbow ammo behavior

Source Code

This mod is open source. Feel free to learn from or contribute to the codebase.

Credits

• Author: Morgott
• Mixin Framework: Hyxin by Jenya705 — CurseForge | GitHub