MyRefinery

MyRefinery lets you decide what a player's own oil refinery is worth: how much low grade fuel it makes from each crude oil, and how fast it works. Players can buy one with a command, and VIPs can have better rates than everyone else.

Out of the box, a Small Oil Refinery turns each crude oil into 3 low grade fuel, slowly. On a server where fuel matters, or where you want a home refinery to be a real reward, that is not something you can change without a plugin. MyRefinery changes it, using the game's own refinery: the same machine, the same screen, the same sounds.

Rates you set

• Yield, as a percentage of what the game gives. 150 makes half as much fuel again; below 100 makes less.
• Speed, as a whole multiple of the game's own. Wood burns at the game's rate, so a faster refinery uses less wood for each crude oil.
• Tiers behind permissions. A vip tier is there to start with; add as many as you like. A refinery works at the best tier its owner holds, whoever is using it.
• Monument refineries are left alone unless you switch them onto the base rates as well.

A refinery to buy

• /refinery buy gives a Small Oil Refinery for a cost you set (the game's own recipe and 100 scrap by default), with no blueprint or workbench needed.
• A limit per player (one by default), with myrefinery.unlimited and myrefinery.free for those you choose.
• Crafting stays in the game's menu with the blueprint, unless you switch it off.
• Only players holding myrefinery.use may buy, craft or place one. One already placed keeps working if its owner loses the permission.

Rates on screen

The game's refinery screen shows no rates, so a small bar beside FUEL shows the refinery's yield and speed. It can be moved or switched off.

Set up in game

/refinery setup opens a panel with every setting, the cost and the tiers. Type a value or click a switch, SAVE, and the new settings are in use at once, with no reload.

Languages

English, Russian, German, French, Spanish, Brazilian Portuguese and Simplified Chinese are built in, and each player sees their own.

Every download is licensed to you and watermarked with your details.

• Set how much low grade fuel each crude oil makes (the game gives 3)
• Set how fast a refinery works, as a multiple of the game's speed
• Tiers behind permissions for VIPs, a vip tier ready to go
• Uses the game's own Small Oil Refinery, screen and sounds
• /refinery buy for a cost you set, no blueprint needed
• Per-player limit, with free and unlimited permissions
• Crafting from the game's menu can stay on or be switched off
• Monument refineries untouched unless you choose otherwise
• A bar on the refinery screen shows its yield and speed
• Every setting edited in game, saved without a reload
• Seven languages built in

1. Download MyRefinery.cs from My Plugins.
2. Drop it into oxide/plugins or carbon/plugins.
3. Grant the permissions:

o.grant group default myrefinery.use
o.grant group admin myrefinery.admin
o.grant group vip myrefinery.vip

On Carbon use c.grant instead of o.grant. The last line is only needed if you have a VIP group.

The file name must stay MyRefinery.cs, because Oxide matches it to the class name.

The config is written to oxide/config/MyRefinery.json (or carbon/configs/MyRefinery.json) on first load. Change it in game with /refinery setup, or edit the file and reload the plugin.

{
  "Yield (percent of the low grade fuel the game makes from each crude oil; 100 is the game's own)": 100.0,
  "Speed (how many times faster than the game it refines, a whole number; 1 is the game's own)": 1,
  "Tiers (name: yield and speed; held with the permission myrefinery.<name>, the owner's best tier is used)": {
    "vip": {
      "Yield (percent of the game's low grade fuel)": 150.0,
      "Speed (times the game's)": 2
    }
  },
  "What one refinery costs with /refinery buy (item short name: amount)": {
    "wood": 200,
    "metal.fragments": 500,
    "lowgradefuel": 250,
    "scrap": 100
  },
  "Most refineries one player may have placed (myrefinery.unlimited ignores it)": 1,
  "Players may also craft one from the game's crafting menu (with the blueprint)": true,
  "The refineries at monuments work at the base yield and speed too": false,
  "Show a refinery's yield and speed in a bar on its screen": true,
  "That bar: its left edge, in pixels right of the screen's centre": 192,
  "That bar: its bottom edge, in pixels above the bottom of the screen": 452
}

Commands

Chat

• /refinery — what your refinery makes, what one costs and how many you have placed
• /refinery buy — pay the cost and get a Small Oil Refinery to place
• /refinery setup — open the settings panel (admins)

Console

• myrefinery.buy, myrefinery.setup — the same, bindable to a key
• myrefinery.status — the rates, tiers and the game's own recipe (server console or myrefinery.admin)

Permissions

• myrefinery.use — buy, craft and place a refinery; grant it to the default group to let everyone
• myrefinery.free — a refinery costs nothing
• myrefinery.unlimited — no limit on how many may be placed
• myrefinery.admin — the setup panel and myrefinery.status
• myrefinery.vip — the vip tier; each tier you add has its own myrefinery.<tier>

A refinery works at the base rates with no permission at all.