About Beehive Storage Adaptor
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!
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
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
PERMISSION EXAMPLES
-------------------
Grant to all players:
o.grant group default beehivestorageadaptor.use
Grant to VIP group only:
o.grant group vip beehivestorageadaptor.use
Grant to specific player:
o.grant user PlayerName beehivestorageadaptor.use
o.grant user 76561198000000000 beehivestorageadaptor.use
Grant admin permissions:
o.grant group admin beehivestorageadaptor.admin
COMMANDS
--------
/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
- Shows statistics: beehives found, adaptors removed, adaptors created
CONFIGURATION
-------------
File Location: oxide/config/BeehiveStorageAdaptor.json
Default Configuration:
{
"Enabled": true,
"DisableBeeSwarms": false,
"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.
- 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 automatically attaches a storage adaptor to the beehive
3. Player can now connect industrial components:
- Conveyors to transport honey/honeycomb
- Power switches to control automation
- Electrical circuits for advanced setups
4. When beehive is destroyed, adaptor is automatically removed
PLAYER WORKFLOW
---------------
1. Place beehive anywhere on the map
2. Notice the storage adaptor automatically appears on the beehive
3. Use conveyor belts or other industrial items to connect
4. Honey and honeycomb automatically transfer through the industrial system
5. Build massive automated honey farms!
ADMIN WORKFLOW
--------------
1. Grant 'use' permission to players/groups who should have this feature
2. Adjust position/rotation in config if needed
3. Use /beehive.reset command to apply config changes to existing beehives
4. Monitor and enjoy players' creative automated honey farms
USE CASES
---------
• VIP Perk: Grant only to VIP players as a premium feature
• Donation Reward: Offer as a reward for server donations
• Server-Wide Feature: Grant to all players for enhanced gameplay
• Roleplay Servers: Create industrial honey production facilities
• PvE Servers: Reduce manual labor for peaceful players
• Modded Servers: Perfect complement to industrial/automation mods
PERFORMANCE
-----------
• Lightweight and optimized
• No continuous loops or timers
• Only processes when beehives are placed or destroyed
• Safe to use on high-population servers
• No performance impact on players without permission
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.)
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
SUPPORT
-------
For support, questions, or feature requests, please contact:
Discord: romzar
VERSION HISTORY
---------------
v1.3.0 - Added DisableBeeSwarms option to remove visual bee effects
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!
═══════════════════════════════════════════════════════════════════════════════