PlayerRanches

Player Ranches turns the vanilla animal fence into a real ranch. A player builds a closed pen with animal fences and an animal fence gate. The plugin detects the pen, the player buys it, and a feeding and water station appears inside. Livestock led into the pen are registered to the ranch and protected. Upgrades add more animal slots, automatic water, and automatic milk, wool and dung collection.

Features

• Build it yourself - no admin setup and no fixed zones. Any closed pen made from animal fences with a gate becomes a ranch.
• Automatic pen detection - the plugin finds the fence loop, measures the area, and tells the player what is wrong if the pen is not closed (for example, where the gap is).
• Ranch UI - buy, upgrade, manage the herd, sell animals, and manage access, all from one panel.
• Tiers - Basic, Standard and Premium by default. Each tier sets the animal cap and unlocks add-ons. Tiers are fully configurable.
• Ranch station - a hitch and trough, a water barrel, and a ranch box are placed inside the pen.
• Auto water - on the Premium tier a powered pump keeps the barrel and the trough full of fresh water.
• Auto-milker - milks ready cows and puts the milk in the ranch box.
• Auto-shearer - shears sheep and puts the wool in the ranch box.
• Dung collector - collects dung into the ranch box.
• Animal protection - ranch animals only take damage from the owner, team, clan and authorized players. Other players cannot lead them away.
• No fence decay - ranch fences and gates do not decay.
• Sell to the server - sell animals at livestock vendor prices, or for the plugin currency.
• Sell or gift to players - offer an animal to another player for a price, with an accept or decline popup.
• Shared access - team members, clan members, and up to 8 authorized players can use a ranch.
• Homed animals - ranch animals stay homed to the pen and roam near its centre.
• Births - newborns join their mother's ranch.
• Currency - any item (default scrap), Economics, or ServerRewards.
• Admin panel - list all ranches, view one, teleport to it, show its outline, re-check it, move or rebuild its station, or remove it.

Requirements

• Oxide / uMod for Rust.
• The plugin uses Harmony patches (included with Oxide).

Optional:

Installation

1. Copy PlayerRanches.cs into oxide/plugins/.
2. The plugin creates oxide/config/PlayerRanches.json on first load.
3. Edit the config if needed, then reload:

oxide.reload PlayerRanches

Permissions

How it works for players

1. Build a pen from animal fences and add an animal fence gate.
2. A popup appears when the gate is detected. It says if the pen is closed or what is missing.
3. Type /myranch and buy the ranch (50 scrap by default).
4. A trough and water barrel are placed inside the pen.
5. Lead livestock into the pen. Each animal is registered to the ranch, up to the tier's animal cap.
6. Upgrade the ranch and buy add-ons in the UI. Produce goes into the ranch box.

Player commands

The command name can be changed in the config.

Admin commands

The ranch outline in the admin panel uses ddraw, so it only shows for players with the admin flag.

Default tiers

Add-on prices: auto-milker 100, auto-shearer 100, dung collector 75.

Configuration

The config file is oxide/config/PlayerRanches.json.

Key defaults:

Notes

• If a pen is opened (a fence is removed or destroyed), new animals do not register and collecting pauses until the pen is closed again.
• If two ranches' fences connect, the ranches merge into one.
• If the owner is offline when an animal sale pays out, the owner is paid on the next /myranch.

Localization

All player messages are in the Oxide lang file (oxide/lang/en/PlayerRanches.json) and can be translated.