Inventory Checkpoints

Player inventories are automatically saved every 30 minutes by default.

Each checkpoint can save:

• Main inventory
• Hotbar
• Armor
• Offhand
• XP level
• XP progress
• Health
• Food level
• Saturation
• Game mode
• World and location
• Timestamp

Each player keeps up to 10 checkpoints. When a new checkpoint is created after the limit, the oldest one is removed.

Perfect for recovering items after accidents, deaths, bugs, or mistakes.

---

Inventory Rollback

Admins can restore a player’s previous inventory using a simple command:

/rollinv checkpoint <player> <1-10>

Example:

/rollinv checkpoint Kelvin 1

1 means the newest checkpoint. 10 means the oldest saved checkpoint.

Before restoring, OneDropCore can create a backup of the player’s current inventory for safety.

---

Web Inventory Viewer

OneDropCore includes a lightweight browser-based inventory viewer.

Default address:

http://server-ip:8906/?token=YOUR_TOKEN

The web viewer shows:

• Online players
• Username
• UUID
• Health
• Food
• XP level
• World
• Location
• Armor slots
• Offhand slot
• Hotbar
• Full inventory grid
• Item amount
• Durability indicator
• Item details

The viewer is protected with a token system so only authorized admins can view player inventories.

AutoTools

Players can toggle AutoTools with:

/autotools

When enabled, OneDropCore automatically selects the best tool from the player’s hotbar when mining blocks.

It can consider:

• Correct tool type
• Tool material tier
• Efficiency enchantment
• Fortune preference
• Silk Touch preference
• Durability protection

This makes mining smoother without requiring players to manually switch tools all the time.

---

AutoMiner

Players can toggle AutoMiner with:

/autominer

AutoMiner can safely mine connected blocks such as ore veins or logs, depending on configuration.

Safety limits include:

• Max blocks per activation
• Blocks per tick
• Cooldowns
• Blacklisted blocks
• Tool durability checks
• Inventory full checks
• TPS/memory safety checks
• Protected block checks

AutoMiner is designed to be useful without destroying server performance.

---

Commands

Command	Description
/odc	Main plugin command
/odc status	View plugin/server status
/odc reload	Reload plugin config
/odc optimize now	Run optimization manually
/odc optimize status	View optimization status
/odc web status	View web server status
/odc web token	Show web access token
/rollinv save <player>	Save checkpoint for a player
/rollinv saveall	Save checkpoints for all online players
/rollinv list <player>	List saved checkpoints
/rollinv checkpoint <player> <1-10>	Restore a checkpoint
/rollinv restorelatest <player>	Restore newest checkpoint
/autotools	Toggle AutoTools
/autotools status	View AutoTools status
/autominer	Toggle AutoMiner
/autominer status	View AutoMiner status
/autominer mode vein	Use vein mining mode
/autominer mode tunnel	Use tunnel mode if enabled

---

Permissions

Permission	Description
onedropcore.admin	Full admin access
onedropcore.optimize	Use optimization commands
onedropcore.rollback	Restore inventory checkpoints
onedropcore.checkpoint.save	Save checkpoints
onedropcore.checkpoint.list	List checkpoints
onedropcore.autotools	Use AutoTools
onedropcore.autominer	Use AutoMiner
onedropcore.autominer.tunnel	Use tunnel mode
onedropcore.web	Access web-related commands

---

Web Inventory Icons

The web inventory viewer supports item icons.

Place PNG files inside:

plugins/OneDropCore/web/assets/items/

Example:

diamond_sword.png iron_pickaxe.png dirt.png golden_apple.png

If an icon is missing, the web viewer will show a clean fallback item box instead.

---

Safety Notes

OneDropCore is designed to be safe for real survival servers.

It avoids:

• Deleting important mobs by default
• Breaking protected blocks
• Running huge laggy loops
• Accessing Bukkit API from unsafe web threads
• Fake TPS boosting
• Fake network optimization
• Unsafe AutoMiner behavior

The plugin focuses on realistic server-side improvement, not fake performance numbers.

---

Important Limitation

A server-side Paper plugin cannot directly detect raw keyboard keys like J from a normal vanilla Minecraft client.

That means AutoMiner is toggled with:

/autominer

If you want a J key toggle, you need a separate client-side mod, macro, or launcher keybind that runs /autominer.

---

Requirements

• Paper server
• Java 21+
• Minecraft 1.20.6+ / 1.21.x recommended

---

Installation

1. Download the plugin jar.
2. Place it into your server’s plugins folder.
3. Restart the server.
4. Edit the config if needed.
5. Use:

/odc status /odc web token

6. Open the inventory viewer:

http://server-ip:8906/?token=YOUR_TOKEN

---

Perfect For

• Survival servers
• SMP servers
• Private friend servers
• Small-to-medium Paper servers
• Servers that need inventory recovery
• Servers that want admin web inventory viewing
• Servers that want safer automation tools

---

Summary

OneDropCore gives server owners a powerful set of tools in one plugin:

• Optimize server load
• Save player inventories
• Restore lost inventories
• View inventories from a browser
• Auto-switch tools
• Auto-mine safely
• Protect the server from overload

One plugin. Many useful systems. Built for practical Minecraft server management.