# OpManager<\/p>\n
\n
\n<\/p>\n
**A safe and lightweight OP management plugin that saves and restores player data when granting temporary operator permissions.**<\/p>\n
Created by **RedCity Industries | Gamer100309**<\/p>\n
—<\/p>\n
## \ud83d\udcd6 Description<\/p>\n
OpManager is a Minecraft plugin designed for server administrators who need to temporarily grant themselves OP permissions without losing their current gameplay progress. Unlike traditional OP commands, OpManager saves your inventory, position, gamemode, and more before granting OP, then restores everything when you’re done.<\/p>\n
Perfect for:
\n– \ud83d\udee0\ufe0f Server maintenance without losing your survival progress
\n– \ud83c\udfae Switching between admin and player modes seamlessly
\n– \ud83d\udd12 Secure temporary OP access with whitelist support
\n– \ud83d\udcbe Multiple storage strategies for different server needs<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### Core Features
\n– **\ud83c\udf92 Complete Data Backup**: Saves inventory, armor, offhand, position, gamemode, XP, health, hunger, and potion effects
\n– **\ud83d\udd04 One-Click Restore**: Automatically restores everything when you remove OP
\n– **\ud83d\udccd Return Command**: Teleport back to your saved position without removing OP
\n– **\ud83c\udfaf Inventory Recovery**: Restore only your inventory while keeping OP active
\n– **\ud83d\udd12 Whitelist System**: Control who can use the plugin
\n– **\ud83c\udf10 Multi-Language**: Built-in English and German support (easily expandable)
\n– **\ud83d\udcbe Flexible Storage**: Choose between RAM-only, disk-only, or hybrid storage
\n– **\ud83d\udc7b Vanish Integration**: Optional automatic vanish disable on \/opoff<\/p>\n
### Safety Features
\n– **\u26a0\ufe0f Item Duplication Warning**: Alerts players about potential duplication if they die during OP sessions
\n– **\ud83d\udd0d Verbose Logging**: Detailed debug mode for troubleshooting
\n– **\ud83d\udcc1 Automatic Cleanup**: Temporary files are deleted after \/opoff
\n– **\ud83d\udee1\ufe0f Data Integrity**: Deep cloning of items prevents unintended modifications<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest `OpManager.jar` from Releases
\n2. Place the file in your server’s `plugins\/` folder
\n3. Restart your server
\n4. Configure `plugins\/OpManager\/config.yml` to your needs
\n5. Add trusted players to the whitelist
\n6. Reload with `\/reload` or restart the server<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
| Command | Description | Aliases |
\n|———|————-|———|
\n| `\/opon` | Grants OP and saves your current player data | `\/op-on`, `\/enableop` |
\n| `\/opoff` | Removes OP and restores your saved player data | `\/op-off`, `\/disableop` |
\n| `\/opreturnback` | Teleports you back to your saved position (keeps OP) | `\/opreturn`, `\/opback` |
\n| `\/opRestoreInventory` | Restores your saved inventory without removing OP | `\/oprestore`, `\/opinv` |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### Quick Setup<\/p>\n
“`yaml
\n# Set your language
\nlanguage: en # or ‘de’ for German<\/p>\n
# Enable\/disable inventory saving
\ninventory_save: true # false = only saves position & gamemode<\/p>\n
# Whitelist protection
\nwhitelist_enabled: true
\nwhitelist:
\n – YourUsername
\n – TrustedAdmin<\/p>\n
# Storage strategy
\nstorage_strategy: DISK_AND_MEMORY # MEMORY_ONLY, DISK_ONLY, or DISK_AND_MEMORY
\n“`<\/p>\n
### Storage Strategies<\/p>\n
| Strategy | Speed | Data Loss Risk | Use Case |
\n|———-|——-|—————-|———-|
\n| `MEMORY_ONLY` | \u26a1 Fastest | \u26a0\ufe0f High (crashes, restarts) | Testing only |
\n| `DISK_ONLY` | \ud83d\udc0c Slower | \u2705 Low | Servers with frequent restarts |
\n| `DISK_AND_MEMORY` | \u26a1 Fast | \u2705 Very Low | **Recommended** for most servers |<\/p>\n
### Vanish Integration<\/p>\n
“`yaml
\n# WARNING: Only enable if your vanish plugin has a dedicated “OFF” command
\nauto_disable_vanish: false
\nvanish_disable_command: “vanish off {player}”
\n“`<\/p>\n
\u26a0\ufe0f **Important**: If your vanish plugin uses a **toggle** command (like `\/vanish` or `\/v`), leave `auto_disable_vanish` set to `false` to avoid accidentally enabling vanish when you meant to disable it!<\/p>\n
—<\/p>\n
## \ud83c\udf10 Multi-Language Support<\/p>\n
OpManager supports multiple languages out of the box:
\n– \ud83c\uddec\ud83c\udde7 English (`messages_en.yml`)
\n– \ud83c\udde9\ud83c\uddea German (`messages_de.yml`)<\/p>\n
### Adding Your Own Language<\/p>\n
1. Copy `messages_en.yml` or `messages_de.yml` ---<\/p>\n ## \ud83d\udd12 Security & Permissions<\/p>\n ### Whitelist System<\/p>\n OpManager uses a **whitelist-based permission system**:<\/p>\n ```yaml \u26a0\ufe0f **Security Warning**: If `whitelist_enabled: false`, **ANY player** can grant themselves OP!<\/p>\n ### Best Practices<\/p>\n 1. \u2705 Always keep `whitelist_enabled: true` in production ---<\/p>\n ## \u26a0\ufe0f Important Warnings<\/p>\n ### Item Duplication Risk<\/p>\n If you **die during an active OP session**, your items will drop at your death location. When you use `\/opoff`, your saved items will be restored. This means you could pick up the dropped items AND have your saved items, resulting in **item duplication**!<\/p>\n **To prevent duplication:** **The plugin will warn you in chat if you die during an OP session.**<\/p>\n ### Vanish Toggle Warning<\/p>\n If your vanish plugin uses a **toggle command** (one command to turn on\/off), setting `auto_disable_vanish: true` could accidentally **enable** vanish instead of disabling it!<\/p>\n **Safe commands** (dedicated OFF): **Risky commands** (toggle): ---<\/p>\n ## \ud83d\udcbe Performance & Resource Usage<\/p>\n ### RAM Usage<\/p>\n OpManager is **extremely lightweight**:<\/p>\n | Scenario | RAM Usage | **In practice**, most sessions use only **10-20 KB** per player due to partially filled inventories and fewer enchantments.<\/p>\n ### Comparison<\/p>\n - **OpManager (1 player)**: 40 KB **Conclusion**: OpManager's memory footprint is negligible compared to your server's overall resource usage.<\/p>\n ---<\/p>\n ## \ud83d\udc1b Troubleshooting<\/p>\n ### Enable Verbose Logging<\/p>\n For detailed debug information, enable verbose logging:<\/p>\n ```yaml This will show detailed information about: ### Common Issues<\/p>\n **Q: My data wasn't saved!** **Q: Items duplicated after death!** **Q: Vanish turned ON instead of OFF!** **Q: Data lost after server crash!** ---<\/p>\n ## \ud83d\udcca Technical Details<\/p>\n ### What Gets Saved<\/p>\n When you run `\/opon` with `inventory_save: true`: With `inventory_save: false`: ### Storage Locations<\/p>\n - **RAM**: Stored in Java HashMap (fastest, volatile) ---<\/p>\n ## \ud83d\udcdd Example Workflow<\/p>\n ``` 2. Do admin work in creative mode 3. Done with admin tasks: \/opoff ---<\/p>\n ## \ud83e\udd1d Contributing<\/p>\n Contributions are welcome! Feel free to: **Pull Requests are welcome!** Please make sure to: ---<\/p>\n ## \ud83d\udcdc License<\/p>\n This project is licensed under the **GNU General Public License v3.0**.<\/p>\n **What this means:** See the LICENSE file for full details or visit https:\/\/www.gnu.org\/licenses\/gpl-3.0.html<\/p>\n ---<\/p>\n ## \ud83d\udcde Support<\/p>\n - **Bug Reports & Feature Requests**: GitHub Issues For general questions, feel free to open a discussion on GitHub!<\/p>\n ---<\/p>\n ## \ud83c\udf89 Credits<\/p>\n **Created by**: RedCity Industries | Gamer100309 ---<\/p>\n ## \u2b50 Star History<\/p>\n If you find this plugin useful, please consider giving it a star on GitHub!<\/p>\n ---<\/p>\n **Made with \u2764\ufe0f by RedCity Industries**<\/p>\n","protected":false},"excerpt":{"rendered":" A safe OP management plugin that saves and restores player data when granting temporary operator permissions.<\/p>\n","protected":false},"featured_media":116504,"template":"","meta":{"_minecraft_slug":"opmanager-rci","_minecraft_project_id":"29VLoApi","_minecraft_author":"Gamer100309","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":37,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"opmanager-rci.zip","_minecraft_size_bytes":33823,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:06:33.495602Z","_minecraft_date_created":"2025-11-24T01:56:47.592038Z","_minecraft_date_modified":"2025-11-19T19:38:43.157374Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/opmanager-rci","_minecraft_icon_attachment_id":116504,"_minecraft_imported_at":"2026-06-06T20:34:07+00:00","_minecraft_import_hash":"37efbac6139b10316ee5ac1c63de251d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-116503","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n2. Rename it to `messages_.yml` (e.g., `messages_fr.yml` for French)
\n3. Translate all messages in the file
\n4. Set `language: fr` in `config.yml`
\n5. Reload the plugin<\/p>\n
\nwhitelist_enabled: true # Set to false to allow ALL players (not recommended!)
\nwhitelist:
\n - AdminName
\n - TrustedModerator
\n```<\/p>\n
\n2. \u2705 Only add trusted administrators to the whitelist
\n3. \u2705 Regularly review your whitelist
\n4. \u2705 Use `DISK_AND_MEMORY` storage for data safety<\/p>\n
\n1. Use `\/opoff` FIRST (restores your saved items)
\n2. Then decide: ignore the dropped items or pick them up<\/p>\n
\n- `vanish off {player}` \u2705
\n- `sv off {player}` \u2705<\/p>\n
\n- `vanish {player}` \u274c
\n- `v {player}` \u274c<\/p>\n
\n|----------|-----------|
\n| 1 player with `\/opon` | ~40 KB (worst case) |
\n| 10 players simultaneously | ~400 KB |
\n| 100 players simultaneously | ~4 MB |<\/p>\n
\n- One loaded Minecraft chunk: ~200 KB
\n- Typical Minecraft server: 2-8 GB<\/p>\n
\nverbose_logging: true
\n```<\/p>\n
\n- Data saving\/loading operations
\n- Inventory copying steps
\n- Position restoration
\n- Storage operations<\/p>\n
\nA: Check if you're on the whitelist and if `inventory_save: true` in config.yml<\/p>\n
\nA: This is expected behavior. Always use `\/opoff` before collecting dropped items.<\/p>\n
\nA: Your vanish plugin uses a toggle command. Set `auto_disable_vanish: false` in config.yml<\/p>\n
\nA: If using `MEMORY_ONLY` storage, this is expected. Switch to `DISK_AND_MEMORY` for safety.<\/p>\n
\n- \u2705 Full inventory (36 slots)
\n- \u2705 Armor (4 slots)
\n- \u2705 Offhand (1 slot)
\n- \u2705 Position (world, x, y, z, yaw, pitch)
\n- \u2705 Gamemode (survival, creative, adventure, spectator)
\n- \u2705 Experience (level and progress)
\n- \u2705 Health
\n- \u2705 Hunger & saturation
\n- \u2705 Potion effects (type, duration, amplifier)<\/p>\n
\n- \u2705 Position
\n- \u2705 Gamemode
\n- \u274c Everything else<\/p>\n
\n- **Disk**: `plugins\/OpManager\/playerdata\/
\n1. You're playing survival: \/opon
\n \u2192 Your survival data is saved
\n \u2192 You receive OP permissions<\/p>\n
\n \u2192 Build, teleport, use WorldEdit, etc.<\/p>\n
\n \u2192 OP is removed
\n \u2192 You're teleported back to your survival location
\n \u2192 Your survival inventory, gamemode, XP, etc. are restored
\n \u2192 Back to playing survival exactly where you left off!
\n```<\/p>\n
\n- \ud83d\udc1b Report bugs via GitHub Issues
\n- \ud83d\udca1 Suggest features via GitHub Pull requests
\n- \ud83c\udf10 Submit translations via GitHub Pull requests
\n- \ud83d\udcdd Improve documentation via GitHub Pull requests<\/p>\n
\n1. Fork the repository
\n2. Create a feature branch (`git checkout -b feature\/AmazingFeature`)
\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
\n4. Push to the branch (`git push origin feature\/AmazingFeature`)
\n5. Open a Pull Request<\/p>\n
\n- \u2705 You can use, modify, and distribute this plugin freely
\n- \u2705 You must share your modifications under GPL v3 as well
\n- \u2705 You must provide source code when distributing
\n- \u274c You cannot sell this plugin without providing the source code<\/p>\n
\n- **Source Code**: GitHub Repository<\/p>\n
\n**Version**: 4.0
\n**Minecraft Version**: 1.21+
\n**API Version**: 1.21<\/p>\n