romzar

═══════════════════════════════════════════════════════════════════════════════ BEEHIVE STORAGE ADAPTOR v1.4.0 Industrial Automation for Beehives by romzar.games ═══════════════════════════════════════════════════════════════════════════════ DESCRIPTION ----------- Beehive Storage Adaptor allows players to connect industrial storage adaptors to beehives, enabling full automation of honey and honeycomb collection through Rust's industrial system. Players can now integrate beehives into their conveyor belt systems, electrical grids, and automated factories! COMPATIBLE WITH BOTH OXIDE/uMOD AND CARBON FRAMEWORKS KEY FEATURES ------------ ✓ Automatic Storage Adaptor Attachment - Automatically attaches a storage adaptor to every beehive placed by authorized players - No player interaction required - completely automatic ✓ Full Industrial System Integration - Connect conveyors directly to beehives - Use electrical switches and power to control honey collection - Build complex automated honey farms ✓ Permission-Based System - Control who can have automated beehives - Perfect for VIP perks or donation rewards - Separate admin permissions for management commands ✓ Fully Configurable - Adjust adaptor position and rotation via config file - Enable/disable the plugin entirely - Fine-tune to match your server's needs ✓ Admin Reset Command - Reposition all adaptors with a single command - Perfect for config adjustments - Works on all existing beehives ✓ Smart Duplicate Prevention - Never creates duplicate adaptors - Safe to reload the plugin anytime - Automatically detects existing adaptors ✓ Automatic Cleanup - Removes adaptors when beehives are destroyed - No orphaned entities - Clean and optimized performance ✓ Disable Bee Swarms (Optional) - Option to remove the visual bee swarms around active beehives - Reduces visual clutter on large honey farms - Configurable - enable/disable as needed - Removes both passive and angry bee effects ✓ Group-Based Limits System - Configure different beehive limits per permission group - Perfect for VIP tiers and donation rewards - Unlimited permission available for admins/special players - Players get helpful upgrade messages when limit reached - Data persistence - limits maintained across restarts ✓ Multi-Language Support - Full English and Portuguese (pt-BR) translations - All player messages localized automatically - Easy to add more languages INSTALLATION ------------ 1. Upload BeehiveStorageAdaptor.cs to oxide/plugins/ 2. The plugin will auto-generate its config file on first load 3. Grant permissions to players/groups (see PERMISSIONS section) 4. Reload the plugin if needed: o.reload BeehiveStorageAdaptor PERMISSIONS ----------- beehivestorageadaptor.use - Required for players to have storage adaptors on their beehives - Without this permission, beehives work normally (no adaptor) beehivestorageadaptor.admin - Required to use the /beehive.reset command - For server administrators only beehivestorageadaptor.unlimited - Bypass all beehive limits - Perfect for admins or special players - No maximum beehive count beehivestorageadaptor.{group} - Group-specific limits configured in config file - Examples: beehivestorageadaptor.default, beehivestorageadaptor.vip, beehivestorageadaptor.premium - Players get the highest limit from all their group permissions PERMISSION EXAMPLES ------------------- Grant to all players with default limit (5 beehives): o.grant group default beehivestorageadaptor.use o.grant group default beehivestorageadaptor.default Grant to VIP group with higher limit (10 beehives): o.grant group vip beehivestorageadaptor.use o.grant group vip beehivestorageadaptor.vip Grant to premium group with highest limit (20 beehives): o.grant group premium beehivestorageadaptor.use o.grant group premium beehivestorageadaptor.premium Grant unlimited beehives to admins: o.grant group admin beehivestorageadaptor.use o.grant group admin beehivestorageadaptor.unlimited Grant to specific player: o.grant user PlayerName beehivestorageadaptor.use o.grant user PlayerName beehivestorageadaptor.vip Grant admin permissions: o.grant group admin beehivestorageadaptor.admin COMMANDS -------- /beehive.limit (Chat) - Check your current beehive limit and usage - Shows how many beehives you have vs your limit - Available to all players with .use permission - Example output: "Beehive Adaptors: 3/10" /beehive.reset (Chat) or beehive.reset (Console) - Requires: beehivestorageadaptor.admin permission - Removes all old adaptors and recreates them with current config settings - Useful when adjusting adaptor position/rotation or limits - Shows statistics: beehives found, adaptors removed, adaptors created - Respects player limits when recreating adaptors CONFIGURATION ------------- File Location: oxide/config/BeehiveStorageAdaptor.json Default Configuration: { "Enabled": true, "DisableBeeSwarms": false, "GroupLimits": { "default": 5, "vip": 10, "premium": 20 }, "AdaptorPosition": { "x": 0.0, "y": 1.5, "z": 0.0 }, "AdaptorRotation": { "x": 0.0, "y": 0.0, "z": 0.0 } } Configuration Options: - Enabled: Set to false to disable the plugin without unloading - DisableBeeSwarms: Set to true to remove the visual bee swarms around active beehives. This removes both the passive bees and angry bees effects. Perfect for large honey farms where many bee swarms can cause visual clutter. - GroupLimits: Dictionary of group names and their beehive limits * "default": 5 = Players with beehivestorageadaptor.default get 5 beehives * "vip": 10 = Players with beehivestorageadaptor.vip get 10 beehives * "premium": 20 = Players with beehivestorageadaptor.premium get 20 beehives * Add as many custom groups as you want * Players with multiple group permissions get the highest limit * Permissions are automatically registered from this config - AdaptorPosition: Position offset relative to the beehive (X, Y, Z coordinates) * Y: 1.5 = on top of beehive (default) * Y: -0.4 = below beehive * Adjust X and Z for horizontal positioning - AdaptorRotation: Rotation of the adaptor in degrees (X, Y, Z) HOW IT WORKS ------------ 1. Player with 'use' permission places a beehive 2. Plugin checks if player has reached their group limit 3. If within limit, plugin automatically attaches a storage adaptor 4. If limit reached, player receives a message with upgrade information 5. Player can now connect industrial components: - Conveyors to transport honey/honeycomb - Power switches to control automation - Electrical circuits for advanced setups 6. When beehive is destroyed, adaptor is removed and count updated 7. Player data is saved persistently across server restarts PLAYER WORKFLOW --------------- 1. Check your limit with /beehive.limit command 2. Place beehive anywhere on the map 3. If within limit, storage adaptor automatically appears 4. If at limit, receive message about current tier and upgrade options 5. Use conveyor belts or other industrial items to connect 6. Honey and honeycomb automatically transfer through the industrial system 7. Build automated honey farms within your tier limit 8. Upgrade to higher tier for more beehives! ADMIN WORKFLOW -------------- 1. Configure GroupLimits in config file for your server tiers 2. Grant 'use' permission and group limit permissions to players/groups 3. Grant 'unlimited' permission to admins or special players if desired 4. Adjust position/rotation in config if needed 5. Use /beehive.reset command to apply config changes to existing beehives 6. Monitor player limits and upgrade requests 7. Enjoy players' creative automated honey farms within balanced limits USE CASES --------- • VIP Tier System: Create multiple tiers with different beehive limits - Free players: 5 beehives - VIP: 10 beehives - Premium: 20 beehives - Staff: Unlimited beehives • Donation Rewards: Offer higher beehive limits as donation rewards • Progressive Gameplay: Players can upgrade their tier to expand honey farms • Server-Wide Feature: Grant base limit to all players for enhanced gameplay • Balanced Economy: Prevent single players from dominating honey production • Roleplay Servers: Create industrial honey production facilities with realistic limits • PvE Servers: Reduce manual labor while maintaining game balance • Modded Servers: Perfect complement to industrial/automation mods with scaling limits DATA FILES ---------- Player data is automatically saved to: oxide/data/BeehiveStorageAdaptor/{steamid}.json Each player's file contains: - Steam ID - List of beehive IDs with adaptors - Last update timestamp Example data file (76561198012345678.json): { "SteamID": 76561198012345678, "BeehiveIDs": [12345678, 87654321, 11223344], "LastUpdated": "2025-10-17T10:30:00.0000000Z" } Data Features: • Persistent across server restarts • Automatic cleanup when beehives are destroyed • Individual files per player for easy management • Can be manually edited if needed (server restart required) LANGUAGE FILES -------------- Plugin automatically generates language files in: - oxide/lang/en/BeehiveStorageAdaptor.json (English) - oxide/lang/pt-BR/BeehiveStorageAdaptor.json (Portuguese) Players automatically see messages in their language based on server settings. Additional languages can be added by creating new lang files. PERFORMANCE ----------- • Lightweight and optimized • Efficient data file system (one file per player) • Only processes when beehives are placed or destroyed • Safe to use on high-population servers • No performance impact on players without permission • Data files load once at server startup • Minimal memory footprint even with thousands of beehives COMPATIBILITY ------------- • Works with vanilla Rust • Compatible with all industrial system items • No conflicts with other plugins • Standalone - no dependencies required • Works with building plugins (CopyPaste, etc.) • Oxide/uMod Framework - Fully Compatible • Carbon Framework - Fully Compatible • Single plugin file works on both frameworks automatically TROUBLESHOOTING --------------- Q: Adaptors aren't appearing on beehives A: Check that players have the 'beehivestorageadaptor.use' permission Q: Multiple adaptors on one beehive A: Use /beehive.reset command to clean up and recreate all adaptors Q: Want to change adaptor position A: Edit the config file, reload plugin, then use /beehive.reset Q: Adaptor position looks wrong A: Adjust AdaptorPosition Y value in config (1.5 = top, -0.4 = bottom) Q: Players without permission have adaptors A: Existing beehives keep adaptors. Remove permission and use /beehive.reset Q: Want to remove bee swarms from beehives A: Set "DisableBeeSwarms": true in config and reload the plugin. The bees will be removed from all active beehives automatically. Q: Bee swarms return after changing DisableBeeSwarms to false A: This is normal - the bees will reappear when the config is set to false Q: Player can't place more beehives A: They've reached their group limit. Check with /beehive.limit command. Grant them a higher tier permission or .unlimited permission. Q: How do I change a player's limit? A: Grant them the permission for a higher tier group: o.grant user PlayerName beehivestorageadaptor.vip Q: Player data not saving A: Check oxide/data/BeehiveStorageAdaptor/ folder exists and has write permissions. Data saves automatically when beehives are placed/destroyed. Q: Want to reset all player data A: Delete files in oxide/data/BeehiveStorageAdaptor/ folder and use /beehive.reset Q: How to add custom group limits? A: Edit config file GroupLimits section, add your group and limit: "elite": 50 Then grant permission: o.grant group elite beehivestorageadaptor.elite SUPPORT ------- For support, questions, or feature requests, please contact: Discord: romzar VERSION HISTORY --------------- v1.4.0 - Group-Based Limits System + Multi-Language Support • Per-player beehive limits based on permission groups • Configurable group limits in config file • Unlimited permission for admins/special players • Data persistence system (saves to player-specific files) • Full English and Portuguese (pt-BR) translations • New /beehive.limit command to check usage • Automatic upgrade suggestions when limit reached • Players get highest limit from all their group permissions v1.3.0 - Added DisableBeeSwarms option + Full Carbon compatibility • Option to disable visual bee swarms • Carbon framework support added • Works on both Oxide and Carbon automatically v1.2.0 - Added permission-based system (use + admin permissions) v1.1.0 - Added /beehive.reset command v1.0.0 - Initial release LICENSE ------- This plugin is provided for use on Rust game servers. Redistribution or resale of this plugin is prohibited. © 2025 romzar.games - All rights reserved. ═══════════════════════════════════════════════════════════════════════════════ Thank you for using Beehive Storage Adaptor! Enhance your server with industrial automation! ═══════════════════════════════════════════════════════════════════════════════