> For the complete documentation index, see [llms.txt](https://floodeer.gitbook.io/manyorbs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://floodeer.gitbook.io/manyorbs/content/fuel-system.md).

# Fuel System

All orbs (except dropped) can have fuel. 

Fuel allows you to create orbs with infinite duration that will be stored in the database, but hook with the Economy system of your server to purchase fuel to make the Orb work.

To refuel an Orb, the player must shift-right-click the Orb Entity, this will open the refuel menu so the player can see all the information about the Orb. 

<mark style="color:$success;">**fuel: VALUE**</mark>
\
Only non-server owned orbs can use Fuel. Server-owned orbs will ignore fuel.

<mark style="color:$success;">**refuel-cost: "PRICE:VALUE"**</mark>
\
If Vault is enabled, players can refuel their orb by right-clicking on the item or shift right-clicking the Entity.
\
Otherwise, set it to 0:0. You can refuel the orb via commands and do it however you like.

<mark style="color:$success;">**fuel-ticking-system: "VALUE"**</mark>
\
Possible values:
\
ACTION - Only consumes fuel when, for example, a crop is placed, tree is planted, effect is given, etc.
\
SECOND - Consumes 1 fuel per second.
\
RANDOM - Randomly consumes 1 fuel at any moment in the Orb lifespan.

You can add Fuel to Any Orb, here's an example:

```yml
fueled_potato:
  type: crops
  block: potatoes
  name: "&e&lFueled Potato Orb"
  lore:
    - "&7Area: &e%aoe%"
    - "&7Duration: &a%duration%s"
    - "&7Cooldown: &c%cooldown%s"
    - "&7Action Delay: &a%delay%"
    - " "
    - "&7Price: &a%price%"
  hologram:
    - "&e&lFueled Farming Orb."
    - " "
    - "&7Area: &e%aoe%"
    - "&7Next Action In: &e%nextAction%s"
    - "&7Fuel: &e%fuel%"
  hologram-height: 3.085
  fuel: 1000
  refuel-cost: "2500:100"
  fuel-ticking-system: "ACTION"
  price: 0
  permission: ""
  aoe: 10
  duration: -1
  ownedByServer: false
  rotate-only: false
  spawn-particles: true
  particles: HAPPY_VILLAGER
  cache-update-delay: -1
  effect-delay: 80
  cooldown: 0
  head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGY0MDlkZWUxYTdmN2ZiODQ1NzNkOGRmMzRkZGFjYmQyMzU1ODBkY2I4NWRlZmU4ODI3NmFlODU2NmJhN2ZmYiJ9fX0="
```