# Amnesia
\n
\nAmnesia is a highly configurable Minecraft plugin for PaperMC and Folia servers that shuffles crafting recipes. It offers two distinct shuffling modes: random item replacement and recipe result swapping.<\/p>\n
## Features<\/p>\n
– **Recipe Shuffling:** Two modes of recipe manipulation:
\n – **Random Item Mode:** Recipe outputs are replaced with random items from the Minecraft item registry.
\n – **Recipe Result Shuffle Mode:** Recipe outputs are shuffled amongst existing recipes.
\n– **Timer-Based Reshuffling:** Automatic reshuffling of recipes at configurable intervals with countdown notifications.
\n– **Seed-Based Rotations:** Ability to use seeds to generate and recall specific recipe shuffles.
\n– **Cross-Restart Synchronization:** Recipe shuffle state and timer settings persist across server restarts.
\n– **Client Recipe Synchronization:** Control how clients handle recipe changes with three different modes.
\n– **Command-Line Interface:** Comprehensive commands for managing shuffling, timer, seed, and configuration.
\n– **Configuration File:** YAML based configuration for persistent settings and customization.
\n– **Performance Focused:** Designed for minimal server impact, especially on Folia servers.
\n– **User Notifications:** Clear and informative messages to players about upcoming and executed recipe shuffles.<\/p>\n
## Commands<\/p>\n
– `\/amnesia shuffle [mode] [seed ## Permissions<\/p>\n – `amnesia.command.shuffle` – Allows use of `\/amnesia shuffle` command. ## Configuration<\/p>\n The plugin uses a `config.yml` file for configuration settings and a `data.yml` file for persistent data. Here’s an example configuration:<\/p>\n “`yaml # Timer interval in seconds (default: 3600 – 1 hour) # Whether the timer-based reshuffling is enabled by default # Client recipe synchronization mode: # List of recipe keys to exclude from shuffling # List of item keys to exclude from being selected in random_item shuffle mode # Countdown intervals (in seconds) for timer notifications # Customizable notification messages The `data.yml` file stores persistent data such as:<\/p>\n “`yaml # Whether the seed was set by the user (true) or generated randomly (false) # Whether recipes are currently shuffled # When recipes were last shuffled (milliseconds since epoch) ## Installation<\/p>\n 1. Download the latest release from the releases page. ## Support<\/p>\n If you encounter any issues or have suggestions, please open an issue on the GitHub repository.<\/p>\n","protected":false},"excerpt":{"rendered":" have you ever wondered what would happen if steve stopped taking his meds?<\/p>\n","protected":false},"featured_media":13648,"template":"","meta":{"_minecraft_slug":"amnesia","_minecraft_project_id":"TIKiVyZF","_minecraft_author":"modpotato","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":60,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"amnesia.zip","_minecraft_size_bytes":42720,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:48:17.684048Z","_minecraft_date_created":"2025-03-08T09:58:51.564813Z","_minecraft_date_modified":"2025-03-06T21:48:26.861225Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/amnesia","_minecraft_icon_attachment_id":13648,"_minecraft_imported_at":"2026-05-31T17:34:35+00:00","_minecraft_import_hash":"7aec8deebfd5206932eec43b22a64e8f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,43,125,89,127],"mod_loader":[131,132],"minecraft_version":[62,37,73,74,38],"class_list":["post-13647","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-cursed","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_loader-folia","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n
\n– `\/amnesia timer [enable|disable|interval
\n– `\/amnesia seed [view|set
\n– `\/amnesia reload` – Reloads the plugin configuration.<\/p>\n
\n– `amnesia.command.timer` – Allows use of `\/amnesia timer` command.
\n– `amnesia.command.seed` – Allows use of `\/amnesia seed` command.
\n– `amnesia.command.reload` – Allows use of `\/amnesia reload` command.<\/p>\n
\n# Shuffle mode: “random_item” or “recipe_result”
\nshuffle-mode: “random_item”<\/p>\n
\ntimer-interval: 3600<\/p>\n
\ntimer-enabled: false<\/p>\n
\n# “resync” – Clients will be resynced with the new recipes (default)
\n# “clear” – Clients won’t get any recipes
\n# “vanilla” – Don’t touch client recipes and let Minecraft handle it
\nclient-sync-mode: “vanilla”<\/p>\n
\nexcluded-recipes:
\n # – “minecraft:stick”<\/p>\n
\nexcluded-random-items:
\n – “minecraft:air”
\n – “minecraft:barrier”
\n # … more items<\/p>\n
\nnotification-intervals:
\n – 300 # 5 minutes
\n – 60 # 1 minute
\n – 30 # 30 seconds
\n # … more intervals<\/p>\n
\nnotification-messages:
\n countdown-5-minutes: “
\n # … more messages
\n“`<\/p>\n
\n# The seed used for recipe shuffling
\nseed: 123456789<\/p>\n
\nuser-set-seed: false<\/p>\n
\nis-shuffled: false<\/p>\n
\nlast-shuffle-time: 0
\n“`<\/p>\n
\n2. Place the JAR file in your server’s `plugins` folder.
\n3. Start or restart your server.
\n4. Configure the plugin by editing the `config.yml` file in the `plugins\/Amnesia` folder.<\/p>\n