Skip to content

Configuration

Ben Woodworth edited this page Oct 2, 2020 · 31 revisions

Configuration Options

  • disable-recipes: Recipes to hide in FastCraft.
    • recipe-ids (Expr List): Recipe IDs to disable.
  • recipe-calculations: Options related to computations for finding craftable recipes.
    • max-tick-usage (Float ≥ 0): How much of each server tick can be utilized. 1 for a full server tick.
  • player-defaults: Default player settings (see the /fastcraft set commands)
    • enabled (Boolean)
  • layout: User interface customization.
    • height (Int): The inventory height. Can be in the range 1..6.
    • recipe-buttons: The region containing craftable recipes. Buttons can be placed in this region.
      • row (Int): The row the recipe region begins. The topmost row is 0.
      • column (Int): The column the recipes begin to appears in. The leftmost column is 0.
      • width (Int): The width of the region containing the recipes.
      • height (Int): The height of the region containing the recipes.
    • buttons
      • crafting-grid, craft-amount, refresh, page:
        • enable (Boolean)
        • item (Item)
        • row (Int): The row the button appears in. The topmost row is 0.
        • column (Int): The column the button appears in. The leftmost column is 0.
    • items: UI items, with optional command to run when clicked
      • <item name>: Name of item entry can be anything
        • enable (Boolean)
        • item (Item)
        • row (Int): The row the button appears in. The topmost row is 0.
        • column (Int): The column the button appears in. The leftmost column is 0.
        • width (Int?): The button width (default is 1)
        • height (Int?): The button height (default is 1)
        • command (StringTemplate?): The server command to execute on click ($player)
    • background: An item shown in all of FastCraft's unused item slots.
      • enable (Boolean)
      • item (Item)

Value Types

  • Int: An integer.
  • Float: A number with a decimal point.
  • Boolean: Either true or false.
  • Expr: An expression to match text.
    • An expression surrounded by / will be treated as a regular expression.
    • All other expressions treat * as a wildcard.
      • * matches 0 or more of any character
    • Example values:
      • iron_sword: Only matches "iron_sword".
      • *gold*: Matches any text containing "gold".
      • minecraft:*stained_glass_pane: Matches all stained glass IDs.
      • /^.*:diamond_(boots|helmet)$/: Matches diamond boots and helmet IDs.
  • Item: An item ID, with an optional data tag.
    • Can be a Minecraft item ID, or a Bukkit Material name.
    • Same format as the id/tag used in the /give command.
    • Example values:
      • crafting_table
      • minecraft:anvil
      • IRON_SWORD{display:{Name:"\"I'm a sword!\""}}
  • StringTemplate: Text with $ substitutions
    • $variable and ${variable} are replaced with the value of variable
    • $$ is replaced with $
    • Example values: (player = "Kepler")
      • "Hello, $player!" -> "Hello, Kepler!"
      • "How many cloned ${player}s are there?" -> "How many cloned Keplers are there?"
      • "$player has $$100.00 in the bank" -> "Kepler has $100 in the bank"