Basic Recipes | Advanced Recipes | Recipe Flags | Recipe Books | Name Index | Commands & Permissions

Recipe flags

WHAT ARE FLAGS ?
フラグってなに？
Flags are the stuff that make a recipe very special! You can add various features to a recipe by using flags.
フラグはレシピを非常に特別な物にするものです！あなたはフラグを使用してレシピに様々な機能を追加することが出来ます。
For examples see advanced recipes.html.
使用例は advanced recipes.html.を見て下さい。

USING FLAGS
フラグの使用

Flags can be added in 3 ‘zones’:
フラグは3’zones(ゾーン)’に追加できます.
– at the beginning of the file – which are copied to all recipes from that file
– ファイルの初めから – そのファイルの全てのレシピにコピーされる。
– after recipe type (CRAFT, COMBINE, etc) – where they affect that specific recipe, you may even overwrite file flags for that specific recipe!
– レシピタイプの後 (CRAFT, COMBINE, など) – それらは特定のレシピに影響を与える場所、あなたは特定のレシピの為のフラグファイルを上書きするかもしれない。
– after recipe’s individual results – to apply flags for the result items.
– 個々のレシピの結果に – 結果にフラグを適用します。

ABOUT ARGUMENTS
引数について

Flags have arguments but not always are they all required.
フラグは引数を持っていますが、それらは全て必要な訳ではありません。
Arguments enclosed between < and > are required and those enclosed between [ and ] are optional.
引数は<と>で囲われてるのは必須、[と]で囲われているのは任意です。
Some arguments may have ‘or false’, that means you can just type false in there to make it do something special (most likely disable the flag or a feature)
いくつかの引数は持っている’あるいはfalse’は、false型がそこにそれが何か特別なことをすることを意味することができる。

ALIASES
エイリアス(仮名)

They’re just other names for the flag that you can use, they have no special effect if used, only for your preference.
それらはあなたが使用できるフラグの別の名前で、使用した場合、特に特別な効果はありませんので、それはあなたの好みで使います。

---

CONTENTS
目次

SHARED FLAGS
– @command
– @keepitem
– @ingredientcondition
– @permission
– @forpermission
– @forchance
– @group
– @world
– @height
– @modexp
– @needexp
– @modlevel
– @needlevel
– @modmoney
– @needmoney
– @cooldown
– @holditem
– @gamemode
– @lightlevel
– @biome
– @weather
– @explode
– @sound
– @summon
– @blockpowered
– @potioneffect
– @launchfirework
– @setblock
– @message
– @broadcast
– @secret
– @temperature

RECIPE ONLY FLAGS
– @addtobook
– @failmessage
– @displayresult
– @remove
– @restrict
– @override

RESULT ONLY FLAGS
– @cloneingredient
– @itemname
– @itemlore
– @leathercolor
– @bookitem
– @fireworkitem
– @fireworkchargeitem
– @skullowner
– @potionitem
– @enchantitem
– @enchantedbook
– @getrecipebook

---

SHARED FLAGS
共有フラグ

Usable on anything – file header, recipe header or result items.
何にでも使用可能 – ファイルヘッダー、レシピヘッダ、あるいはできあがったアイテム

---

^ Contents

@command <text or false>

Executes the command when recipe is successful.
レシピが成功したときにコマンドが実行されます.
This flag can be used more than once to add more commands to the list.
このフラグは、リストに複数のコマンドを追加する為に、複数回使うことができます。

Commands are executed server-side, if you add / prefix it will execute the command on the crafter.
コマンドはサーバ側で実行されます。もしあなたが追加した場合、クラフターがコマンドを実行しするなら接頭語「/」を追加します。

You can also use these variables:
これらの変数を使用することができます

• {player}
  = crafter’s name or ‘(nobody)’ if not available(クラフターの名前、名前がわからない場合は(nobody))
• {playerdisplay}
  = crafter’s display name or ‘(nobody)’ if not available
• {result}
  = the result item name or ‘(nothing)’ if recipe failed.
• {recipename}
  = recipe’s custom or autogenerated name or ‘(unknown)’ if not available
• {recipetype}
  = recipe type or ‘(unknown)’ if not available
• {inventorytype}
  = inventory type or ‘(unknown)’ if not available
• {world}
  = world name of event location or ‘(unknown)’ if not available
• {x}
  = event location’s X coord or ‘(?)’ if not available
• {y}
  = event location’s Y coord or ‘(?)’ if not available
• {z}
  = event location’s Z coord or ‘(?)’ if not available

Setting to ‘false’ or ‘remove’ will disable the flag.
‘false’か’remove’を設定すると、フラグは無効になります。

Examples:
@command /say I crafted {result}!
@command kick {player}

Aliases: @cmd, @commands

---

^ Contents

@keepitem <ingredient>
@keepitem <ingredient> | damage <num>
@keepitem <ingredient> | replace <item>

Keeps the specified ingredient material from being used when crafting.
クラフトしたときに指定された材料を保持します。
This flag can be used more than once to specify more ingredients.
このフラグは複数の材料を指定するために、複数回使用できます。

The <ingredient> argument can be a material:data combination of the ingredient, data value being optional, just like defining an ingredient.
<ingredient(材料)>の引数は、material:dataを組み合わせた材料です。データ値は任意で指定します。

For the optional ‘damage <num>’ argument you can specify the amount of damage to add or remove from a damageable item.
オプション’damage <num>’引数は、痛んだアイテムに損傷度合いを追加、あるいは削除することが出来ます。
Damaging the item beyond its max durability will break it.
最大の耐久性を超えたダメージはそれを破壊します。
This argument only works for damageable items and the <num> can be a positive number to damage the item or negative to repair it.
この引数は、耐久度を持つアイテムに、それを修復する正のの値か、損傷度合いを付与する正の値を指定出来ます。

For the optional ‘replace <item>’ argument you can specify an item that will replace the ingredient.
オプション’replace <item>’引数は、あなたは材料を置き換える項目を追加できます。
The <item> on ‘replace’ argument can support material:data:amount and enchantments, just like recipe results.
‘replace’引数の<item>は、レシピの結果に「material:data:amount」とエンチャントをサポートできます。
This argument only works for unstackable ingredients. The item specified as replacement can be stackable.
この引数はスタックできない材料に指定出来ます。代替えとして指定されたアイテムはスタックできます。

Setting to ‘false’ or ‘remove’ will disable the flag.
‘false’か’remove’を設定すると、フラグは無効になります。

Examples:
@keepitem iron_axe // makes the iron_axe ingredient persistent
@keepitem potion | replace bottle // using any kind of potion would return an empty bottle
@keepitem diamond_pickaxe | damage 5 // keeps the diamond pickaxe but damages it by 5 points
@keepitem shears | damage -99999 // keeps shears and fully repairs it

Aliases: @returnitem, @replaceitem

---

^ Contents

@ingredientcondition <item> | <conditions>

Adds conditions for individual ingredients like ranged data values, enchantments or using stacks.
個々の材料に、範囲のデータ値、エンチャント、スタックの使用の状態を追加します。
This flag can be called more than once to add more ingredients with conditions.
このフラグは、条件以上の材料を追加して複数回呼び出すことができます。

The <item> argument must be an item that is in the recipe, ‘material:data’ format.
引数<item>は「material:data」の形式で、レシピにある項目でなければなりません。
If you’re planning to add ranged data values the data value must be the wildcard ‘*’ or not set at all in order to work.
範囲データ値の追加を計画している場合、データ値がワイルドカード’*’であるか、または動作させるために全て設定しなければなりません。

For <conditions> argument you must specify at least one condition.
<conditions>引数は、少なくとも一つの条件を指定する必要があります。
Conditions must be separated by | and can be specified in any order.
条件は|で区切る必要があり、任意の順序で指定することができます。
Condition list:
条件リスト:

• data <[!][&]num or min-max or all or vanilla or damaged or new>, […]
  Condition for data/damage/durability, as argument you can specify data values separated by , character.
  One number is required, you can add another number separated by – character to make a number range.
  Additionally instead of the number you can specify ‘item:data’ to use the named data value.
  Special data values:
  all: Flips the data check to allow all data values instead of none initially.
  vanilla: Only allow data values within the vanilla ranges.
  new: Equivalent to 0, or an undamaged item.
  damaged: On weapons and armor, this is everything within vanilla limits that is considered a damaged item.
  Prefixing with ‘&’ would make a bitwise operation on the data value.
  Prefixing with ‘!’ would reverse the statement’s meaning making it not work with the value specified.
  Optionally you can add more data conditions separated by ‘,’ that the ingredient must match against one to proceed.
  Defaults to the equivalent of !all.
• enchant <name> [[!]num or min-max], […]
  Condition for applied enchantments (not stored in books).
  This argument can be used more than once to add more enchantments as conditions.
  The name must be an enchantment name, see ‘name index.html’ at ‘ENCHANTMENTS’ section.
  The 2nd argument is the levels, it’s optional
  A number can be used as level to set that level as requirement.
  You can also use ‘max’ to use the max supported level for that enchantment.
  Additionally a second number separated by – can be added to specify a level range, ‘max’ is also supported in ranged value.
  Prefixing with ‘!’ would ban the level or level range.
• noenchant or !enchant
  Ingredient must have no enchantment
  Overrides enchant condition if set
• amount <num>
  = stack amount, this will also subtract from the ingredient when crafted!
• name <text or regex:pattern>
  = check the item name against exact text or if prefixed with ‘regex:’ it will check for a regex pattern.
• noname or !name
  Ingredient must have no/default name
  Overrides name condition if set
• lore <text or regex:pattern>
  = checks each lore line for a specific text or if prefixed with ‘regex:’ it will check for a regex pattern.
• nolore or !lore
  Ingredient must have no lore
  Overrides lore condition if set
• color <colorname or R,G,B>
  = only works for leather armor, checks color, the values can be individual values or ranged separated by – char or you can use a color name constant, see ‘name index.html’ at ‘DYE COLOR’.
• nocolor or !color
  Only works for leather armor
  Ingredient must have default/vanilla color
  Overrides color condition if set
• nometa or !meta
  Ingredient must have no metadata (enchants, name, lore, color)
  Overrides enchant, name, lore, color conditions if set
  Equivalent to noenchant | noname | nolore | nocolor
• failmsg <text>
  = overwrite message sent to crafter when failing to provide required ingredient.

This flag can be used on recipe results to determine a specific outcome for the recipe depending on the ingredients, however in that case you would need ‘failmsg false’ along with @displayresult flag too, see ‘advanced recipes.html’ file for example.

NOTE: if an ingredient exists more than once in the recipe then the conditions will apply to all of them.
NOTE: this flag can not be used in recipe header, needs to be defined on individual results or recipes.

Setting to ‘false’ or ‘remove’ will disable the flag.
‘false’か’remove’を設定すると、フラグは無効になります。

Examples:
@ingredientcondition wood | data 3 // pointless use of this flag, just use wood:3 as ingredient.
@ingredientcondition wood | data 1-3, 39, 100 // this overwrites the data condition to the previous one.
@ingredientcondition dirt | amount 64 // needs a full stack of dirt to work.
@ingredientcondition iron_sword | data 0-25 // only accepts iron swords that have 0 to 25 damage.
@ingredientcondition wool | data vanilla, !wool:red // no red wool
@ingredientcondition wool | data all, !vanilla // only modded data values
@ingredientcondition iron_sword | data new // Only allow undamaged iron swords
@ingredientcondition gold_sword | data damaged // Only allow damaged gold swords
@ingredientcondition potion | data &16384, !&64 // checks if potion is splash and NOT extended (see http://www.minecraftwiki.net/wiki/Data_value#Potions)
@ingredientcondition diamond_helmet | enchant fire_resistance 1-3 | enchant thorns | data 0, 5, 50-100 // makes ingredient require 2 enchantments and some specific data values.
@ingredientcondition stick | nometa // makes ingredient require a vanilla stick.
@ingredientcondition stick | !meta // Same as above.
@ingredientcondition stick | name Crafted Stick | nolore | noenchant // makes ingredient require a stick with a name of ‘Crafted Stick’, but no lore or enchantments.

Aliases: @ingrcondition, @ingrcond, @ifingredient, @ifingr

---

^ Contents

@permission [!]<permission>, […] | [fail message]

Makes the recipe or item require the crafter to have a permission.
権限がなければレシピの作成や必要とするアイテムを得られません。
Using this flag more than once will add more permissions, the player must have at least one to allow crafting.
このフラグを複数使用した場合はより多くの権限を追加します。プレイヤーへクラフトを許可するには少なくとも一つの権限が必要です。

The ‘<permission>’ argument must be an permission node, regardless if it exists or not.
‘<permission>’ 引数はそれが存在するかどうかにかかわらず許可ノードでなければならない。

Adding ! character as prefix to individual permission nodes will do the opposite check, if crafter has permission it will not craft.
個々の権限ノードに接頭語!を追加した場合は、逆の権限をクラフターへ与えます。

You can also specify more permissions separated by , character.
複数のパーミッションはカンマで区切れます。

Optionally you can specify a failure message that will be used on the specific permission(s) defined.
任意ですが、定義された特定の権限(複数可能)で使用されるエラーメッセージを定義できます。
The messages can have the following variables:
メッセージには次の変数を持たせる事ができます。

• {permission}
  = permission that was not found or was found and it’s unallowed.
• {permissions}
  = a comma separated list of the allowed or unallowed permission nodes.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@permission ranks.vip
@permission !jobs.builder | <red>Builders can’t use this!
@permission jobs.farmer, jobs.trader | <red>You must be a farmer or trader!
@permission ! ranks.newbs, ! ranks.newbies | <yellow>Noobs can’t use this. // valid with spaces too

Aliases: @permissions, @perm

---

^ Contents

@forpermission <permission node> @<flag declaration>

Adds other flags with permission requirements.
権限許可の要件に他のフラグを追加します。

You can specify this flag more than once to add more permissions or more flags to a permission.

Basically this is a storage for flags and will only trigger them if the crafter has the required permission.
This is useful for using different values for flags on the same recipe but for different permissions.

The ‘<permission node>’ argument must be a permission node.
The ‘<flag declaration>’ must be a flag that will work on the current recipe or result.
For extra awesomeness you can even add this flag inside itself!

NOTE: This will trigger all flags that player has permission for which means that flag effects will stack up.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@exp -2 // you can use original flag as is for players that do not have the permission
@forpermission farmer.newbs @exp 4 // add 4 exp to the original -2 exp so player will have +2 exp
@forpermission farmer.uber @exp 50 // add 50 exp to the original -2 exp and also add 4 exp if the player has that node too
@forpermission farmer.uber @level 1 // if has required give the crafter 1 level

Aliases: @forperm

---

^ Contents

@forchance <group> [chance]% [^]@[flag declaration]
@forchance <chance>% [^]@<flag declaration>

Triggers other flags or groups of flags by specified chance.
指定されたチャンスに、他のフラグかグループのフラグのトリガー。
Using this flag more than once will add more flags.
このフラグを何度も使うと、複数のフラグを追加できます。

The ‘group’ argument defines a group for the flags (not permission related), can be any combination of letters only, no spaces either.
Grouping flags makes the system pick only one flag from the bunch which means it’s also limited to 100% total chance.
If a group is not defined then the flags will be added to the default group which is a special group that will trigger flags randomly according to their chance, it can trigger all at once or even none at all.

The ‘chance’ argument suggests a chance value that can be between 0.01 and 100 and the ‘%’ suffix is required.
The chance argument is only optional if there’s a group defined, then the remaining chance will be evenly split between all flags with undefined chance.

The ‘flag declaration’ is a flag like you’d add a flag to a recipe or result, you can even add this flag into itself to make multi-chance structures.
The flag declaration argument is only optional if there’s a group defined and will act as literally nothing.
Optionally you can prefix the flag declaration with the ‘^’ character to append the data from the flag to the previous flag of the same type from the same group (no group is still a group, but a special one).

NOTE: If using ‘^’ prefix, always use ‘^’ and ‘@’ together like ‘^@’, no space in between.
NOTE: In a group there must be at least a chance value or a flag declaration.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
// some simple example
@forchance 25% @explode // 25% chance to explode
// appending to flags example
@forchance 80% @command say high chance message!
@forchance 50% @command say 50-50 message… // this is a totally new flag, individual from the previous one.
@forchance ^@command say extra message! // this command will be appended to the previous command flag.
@forchance ^@command say extra-large message!!! // this will also add append to the same previous command flag, now it has 3 commands.
// all flags in a group must have a total of 100% chance since only one triggers, in this case the chance is calculated and it would be 33.33% for each.
@forchance mystuff @sound level_up
@forchance mystuff @sound note_bass
@forchance mystuff @sound hurt
// example of empty flag definition as nothing chance
@forchance dostuff @broadcast yay!
@forchance dostuff 75% // this sets the ‘dostuff’ group to do nothing 75% of the time
// forchanception
@forchance 50% @forchance 25% @forchance test @broadcast chanception occurred!
// NOTE all of the examples above can be used in a single recipe if you want, there’s no limit to the combinations!

Aliases: @bychance, @chance

---

^ Contents

@group [!]<group>, […] | [fail message]

Makes the recipe or item require the crafter to be in a permission group.
作成したレシピかクラフターへのアイテム要求が権限グループに含まみます。
Using this flag more than once will add more groups, the player must be in at least one group.
このフラグを何度も使うと、複数のグループを追加できます。プレイヤーは少なくとも1つのグループに属する必要があります。

The ‘<group>’ argument must be a permission group.

Adding ! character as prefix to individual groups will do the opposite check, if crafter is in group it will not craft.

You can also specify more groups separated by , character.

Optionally you can specify a failure message that will be used on the specific group(s) defined.
The messages can have the following variables:

• {group}
  = group that was not found or was found and it’s unallowed.
• {groups}
  = a comma separated list of the allowed or unallowed groups.

NOTE: Vault with a supported permission plugin is required for this flag to work.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@group ranks.vip
@group !jobs.builder | <red>Builders can’t use this!
@group jobs.farmer, jobs.trader | <red>You must be a farmer or trader!
@group ! ranks.newbs, ! ranks.newbies | <yellow>Noobs can’t use this. // valid with spaces too

Aliases: @groups, @permissiongroup, @permgroup

---

^ Contents

@world [!]<world>, […] | [fail message]

Makes the recipe or item work only in certain worlds.
特定のワールドでのみ、レシピの作成やアイテムの使用ができる。
Using this flag more than once will add more worlds.
何度もこのフラグを使用すると、複数のワールドを追加できる。

The ‘<world>’ argument can be a world name.
Adding ! character as prefix to individual worlds will do the opposite check, will not craft in specified world.
You should require or disallow worlds, using both would be logically pointless.

Optionally you can specify a failure message that will be used on the specific world(s) defined.
The messages can have the following variables:

• {world}
  = current world.
• {worlds}
  = a comma separated list of the required or unallowed worlds.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@world world // only allows ‘world’
@world !world_nether // disallows ‘world_nether’
@world world1, world2, world3 | <red>Need to be in world 1, 2 or 3! // requires one of the 3 worlds

Aliases: @needworld, @worlds

---

^ Contents

@height <min or min-max> | [fail message]

Checks if crafter or furnace is at least at ‘min’ height and optionally at most ‘max’ height.
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

Optionally you can overwrite the fail message or you can use ‘false’ to hide it.
In the message the following variables can be used:

{height} = height or height range

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@height 200 // must be high in the sky
@height 0-30 | <red>You need to be deep underground!

Aliases: @depth

---

^ Contents

@modexp [modifier]<amount> | [fail message]

Modifies crafter’s experience points.
クラフターの経験値を変更します。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

The ‘[modifier]’ argument can be nothing at all or you can use + (which is the same as nothing, to add), – (to subtract) or = (to set).
The ‘<amount>’ argument must be the amount of experience to modify.
The ‘[fail message]’ argument is optional and can be used to overwrite the default message or you can set it to false to hide it. Message will be printed in chat.
For the fail message you can use the following arguments:

• {amount}
  = amount defined in the flag, never has modifier prefix.
• {modifier}
  = the modifier prefix.
• {actualamount}
  = (only works for – modifier) the actual amount lost.

NOTE: This is for total experience points, for experience levels use @modlevel
NOTE: This flag does not check if player has enough experience when subtracting! Use in combination with @needexp if you want to check.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@modexp 25 // gives 25 experience to crafter
@modexp +25 // exactly the same as above
@modexp -50 | <red>You lost {amount} exp! // takes at most 50 experience from crafter, if he does not have that amount it will be set to 0.
@modexp = 0 | <red>You lost all your experience! // sets crafter experience to 0, that space is valid there too.

Aliases: @expmod, @modxp, @xpmod, @exp, @xp, @giveexp, @givexp, @takeexp, @takexp

---

^ Contents

@needexp <min or min-max> | [message]

Checks if crafter has at least ‘min’ experience and optionally at most ‘max’ experience.
クラフターの最小経験値か、任意で最大経験値をチェックします。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

Optionally you can overwrite the fail message or you can use ‘false’ to hide it.
In the message the following variables can be used:

• {exp}
  = exp or exp range.
• {minexp}
  = defined min exp range.
• {maxexp}
  = defined max exp range.
• {playerexp}
  = player’s current experience.

NOTE: This is for total experience points, for experience levels use @needlevel

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@needexp 100 // player needs to have at least 100 experience to craft
@needexp 250-250 // player needs to have exactly 250 experience to craft
@needexp 0-500 // player can only craft if he has between 0 and 500 experience
@needexp 1000 | <red>Need {exp} exp!

Aliases: @needxp, @reqexp, @expreq, @reqxp, @xpreq

---

^ Contents

@modlevel [modifier]<number> | [fail message]

Modifies crafter’s level.
クラフターのレベルを変更します。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

The ‘[modifier]’ argument can be nothing at all or you can use + (which is the same as nothing, to add), – (to subtract) or = (to set).
The ‘<number>’ argument must be the amount of levels to modify.
The ‘[fail message]’ argument is optional and can be used to overwrite the default message or you can set it to false to hide it. Message will be printed in chat.
For the fail message you can use the following arguments:

• {amount}
  = amount defined in the flag, never has modifier prefix.
• {modifier}
  = the modifier prefix.
• {actualamount}
  = (only works for – modifier) the actual amount lost.

NOTE: This is for experience levels, for experience points use @modexp
NOTE: This flag does not check if player has enough levels when subtracting! Use in combination with @needlevel if you want to check.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@modlevel 1 // gives 1 level to crafter
@modlevel +1 // exactly the same as above
@modlevel -2 | <red>You lost {amount} levels. // takes at most 2 levels from crafter, if he does not have that amount it will be set to 0.
@modlevel = 0 | <red>You’ve been set to level 0! // sets crafter’s level to 0, that space is valid there too.

Aliases: @levelmod, @setlevel, @level

---

^ Contents

@needlevel <min or min-max> | [fail message]

Checks if crafter has at least ‘min’ levels and optionally at most ‘max’ levels.
クラフターの最小レベルか、任意で最大レベルをチェックします。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

Optionally you can overwrite the fail message or you can use ‘false’ to hide it.
In the message the following variables can be used:

{level} = level or level range

NOTE: This is for experience levels, for experience points use @needexp or for world height use @height.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@needlevel 1 // Requires a minimum level of 1
@needlevel 5-5 // Requires exactly level 5
@needlevel 25-100 | <red>Need level 25 to 100!

Aliases: @reqlevel, @levelreq

---

^ Contents

@modmoney [modifier]<float number> | [fail message]

Modifies crafter’s money.
クラフターのお金を変更します。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

The ‘[modifier]’ argument can be nothing at all or you can use + (which is the same as nothing, to add), – (to subtract) or = (to set).
The ‘<number>’ argument must be the amount of money to modify.
The ‘[fail message]’ argument is optional and can be used to overwrite the default message or you can set it to false to hide it. Message will be printed in chat.
For the fail message you can use the following arguments:

• {amount}
  = amount defined in the flag, never has modifier prefix.
• {modifier}
  = the modifier prefix.

NOTE: Vault with a supported economy plugin is required for this flag to work.
NOTE: This flag does not check if player has enough money when subtracting! Use in combination with @needmoney if you want to check.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@modmoney 0.5 // gives 0.5 currency or 50 minor currency money to crafter
@modmoney +0.5 // exactly the same as above
@modmoney -2.5 | <red>You lost {money}! // takes at most 2.5 currency from crafter, if he does not have that amount it will be set to 0.
@modmoney = 0 | <red>You lost all your money! // sets crafter’s money to 0, that space is valid there too.

Aliases: @moneymod, @setmoney, @money

---

^ Contents

@needmoney <min or min-max> | [fail message]

Checks if crafter has at least ‘min’ money and optionally at most ‘max’ money.
クラフターの最小所持金か、任意で最大所持金をチェックします。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

Optionally you can overwrite the fail message or you can use ‘false’ to hide it.
In the message the following variables can be used:

{money} = money or money range; formatted with currency.

NOTE: Vault with a supported economy plugin is required for this flag to work.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@needmoney 0.25
@needmoney 0.1 – 1000 | <red>Need {money}!

Aliases: @reqmoney, @moneyreq

---

^ Contents

@cooldown <number>[suffix] | [arguments]
@cooldown false

Sets a cooldown time for crafting a recipe or result.
レシピや結果を得るのに、待ち時間を設定します。
Once a recipe/result is used, the crafter can not craft it again for the specified amount of time.
レシピや結果に使うと、クラフターは指定された時間だけ、それを再び作る事ができなくなる。
If set on a result, the result will be unavailable to the crafter for the cooldown time but the rest of results and the recipe will work as before.
NOTE: cooldown is reset when reloading/restarting server.
メモ：待ち時間はサーバがリロード/リセットされると、初期化される。

The <number> argument must be a number, by default it’s seconds.
The [suffix] argument defines what the <number> value is scaled in, values for suffix can be:

s = for seconds (default)
m = for minutes
h = for hours

You can also use float values like ‘0.5m’ to get 30 seconds.

Optionally you can add some arguments separated by | character, those being:
global = make the cooldown global instead of per-player.

msg <text> = overwrites the information message; false to hide; supports colors; use {time} variable to display the new cooldown time.
failmsg <text> = overwrites the failure message; false to hide; supports colors; use {time} variable to display the remaining time.
Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@cooldown 30
@cooldown 30s // exactly the same as the previous flag
@cooldown 1.75m | failmsg <red>Usable in: {time} // 1 minute and 45 seconds or 1 minute and 75% of a minute.
@cooldown .5h | global | failmsg <red>Someone used this recently, wait: {time} | msg <yellow>Cooldown time: {time} // half an hour

Aliases: @cooltime, @delay

---

^ Contents

@holditem <item or false>

Makes the recipe require crafter to hold an item.
クラフターがアイテムを保持するために必要なレシピになります

This flag can be used more than once to add more items, the player will need to hold one to craft.

The <item> argument can be in this format: material:data:amount
Just like recipe results, not all values from the item are required.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@holditem iron_pickaxe // any data/damage value
@holditem iron_axe:0 // only undamaged axe!
@holditem chainmail_helmet | protection_fire:1 // requires chain helmet with any level of damage and fire protection enchant level 1
@holditem false // makes all previous statements useless

Aliases: @hold

---

^ Contents

@gamemode <game mode>
@gamemode <game mode> | [message]
@gamemode false

Requires the crafter to be in a specific game mode.
特定のゲームモードで作成可能になります。
Using this flag more than once will overwrite the previous ones.
このフラグは複数使うと、前のフラグを上書きします。

Values for <game mode> can be: c or creative, a or adventure, s or survival

Optionally you can specify a failure message, should be short because it prints in the display result.
Additionally you can use the following variables in the message:

• {playergm}
  = player’s game mode (which is not allowed)
• {gamemodes}
  = list of required game modes

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@gamemode creative // only creative
@gamemode s // only survival
@gamemode a,s // only adventure and survival
@gamemode false // disable flag, allow all gamemodes

Aliases: @needgm

---

^ Contents

@lightlevel <min or min-max> [type] | [fail message]

Checks for the light level.
明るさレベルをチェックします。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

The first argument must be a number from 0 to 15 to set a minimum light level, or you can specify a number range separated – character.
最初の引数は最低限の光レベルとして0～15の数値を指定し、ハイフンで範囲を指定できます。

Optionally you can set the [type] argument to specify light type:

any = (default) any kind of light.
sun = sun light only.
blocks = light form blocks (torches, furnaces, etc) only.

You can also overwrite the fail message or use ‘false’ to hide it.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@lightlevel 14 sun
@lightlevel 0-4 blocks | <red>Kill the lights!

Aliases: @blocklight, @sunlight, @light

---

^ Contents

@biome <types> | [fail message]

Sets the biome required to allow crafting.
特定のバイオームでクラフティングが可能になります。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

For ‘<types>’ you can list the biomes you want to allow or disallow.
It needs at least one biome name and you can add more separated by , character.
Also you can disallow biomes by prefixing them with ! character.
Biomes:

swampland, forest, taiga, desert, plains, hell, sky, ocean, river, extreme_hills, frozen_ocean, frozen_river, ice_plains, ice_mountains, mushroom_island, mushroom_shore, beach, desert_hills, forest_hills, taiga_hills, small_mountains, jungle, jungle_hills, jungle_edge, deep_ocean, stone_beach, cold_beach, birch_forest, birch_forest_hills, roofed_forest, cold_taiga, cold_taiga_hills, mega_taiga, mega_taiga_hills, extreme_hills_plus, savanna, savanna_plateau, mesa, mesa_plateau_forest, mesa_plateau, sunflower_plains, desert_mountains, flower_forest, taiga_mountains, swampland_mountains, ice_plains_spikes, jungle_mountains, jungle_edge_mountains, cold_taiga_mountains, savanna_mountains, savanna_plateau_mountains, mesa_bryce, mesa_plateau_forest_mountains, mesa_plateau_mountains, birch_forest_mountains, birch_forest_hills_mountains, roofed_forest_mountains, mega_spruce_taiga, extreme_hills_mountains, extreme_hills_plus_mountains, mega_spruce_taiga_hills

The biomes names can also be found in ‘name index.html’ file at ‘BIOMES’ section.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@biome jungle, jungle_hills
@biome !mushroom_island, !mushroom_shore

---

^ Contents

@weather <type>, [type] | [fail message]

Sets the weather type(s) required to allow crafting.
特定の天気をクラフティングで要求します
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

The ‘type’ argument can be:

clear = clear skies, no precipitation.
downfall = precipitation (rain/snow depends on biome).
thunder = precipitation + thundering.

You can set more than one type separated by , character, but setting all of them is pointless.

Optionally you can set the ‘fail message’ argument to overwrite the failure message or set it to ‘false’ to hide it.
In the fail message you can use the following variables:

{weather} = the weather type required.

NOTE: If you need to check if it’s raining or snowing then use the @temperature flag.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@weather downfall // works only if it’s raining peacefully.
@weather clear, thunder | <red>To be struck by lightning… or to be not.

---

^ Contents

@explode <arguments or false>

Makes the workbench/furnace/player explode when recipe is crafted.
レシピが作成された時に、作業台/かまど/プレイヤーが爆発します。
This flag can only be declared once per recipe and once per result.
このフラグはレシピの結果毎に、一度だけ宣言することができます。

Replace <arguments> with the following arguments separated by | character:

• power <0.0 to …>
  = (default 2.0) Set the explosion power, value multiplied by 2 is the range in blocks; TNT has 4.0
• fire
  = (default not set) Explosion sets fires.
• nobreak
  = (default not set) Makes explosion not break blocks.
• nodamage [self]
  = (default not set) Explosion doesn’t damage players or only the crafter if ‘self’ is specified.
• fail
  = (default not set) Explode if recipe failed as opposed to succeed.

All arguments are optional and you can specify these arguments in any order.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@explode // will explode when recipe succeeds with power 2, 100% chance and breaks blocks
@explode nobreak | fire | chance 25% | power 6 // will explode 25% of time without block damage but sets fires
@explode fail | power 2 | chance 75% // will explode 75% of the time when recipe fails

Aliases: @explosion, @boom, @tnt

---

^ Contents

@sound <sound> | [arguments]

Plays a sound at crafting location.
作成場所で音楽を流します。
Using this flag more than once will overwrite the previous flag.
このフラグは複数使うと、前のフラグを上書きします。

The <sound> argument must be a sound name, you can find them in ‘name index.html’ file at ‘SOUND LIST’ section.

Optionally you can specify some arguments separated by | character:

• volume <0.0 to 100.0>
  = (default 1.0) sound volume, if exceeds 1.0 it extends range, each 1.0 extends range by about 10 blocks.
• pitch <0.0 to 4.0>
  = (default 0.0) sound pitch value.
• player
  = (default not set) if set it will only play the sound to the crafter.

You can specify these arguments in any order and they’re completely optional.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@sound level_up
@sound wolf_howl | volume 5 // can be heard loudly at 50 blocks away
@sound portal_travel | player | volume 0.65 | pitch 3.33

Aliases: @playsound

---

^ Contents

@summon <type> | [arguments]

Summons a creature.
生物を召喚します。
Using this flag more than once will add more creatures.
このフラグを何度も使用すると、より多くの生物が追加されます。

The <type> argument can be a living entity type, you can find all entity types in ‘name index.html’ file.

Optionally you can add some arguments separated by | character, those being:

• adult
  = forces creature to spawn as an adult, works with animals and villagers (works opposite of baby).
• agelock
  = prevent the creature from maturing or getting ready for mating, works with animals and villagers.
• angry
  = makes creature angry, only works for wolves and pigzombies; you can’t use ‘pet’ with this.
• baby
  = spawn creature as a baby, works with animals, villagers and zombies (works opposite of adult).
• cat <type>
  = ocelot type, available values: wild_ocelot, black_cat, red_cat, siamese_cat
• chance <0.01-100>%
  = chance of the creature to spawn, this value is for individual creatures.
• chest <item> [drop%]
  = equip an item on the creature’s chest with optional drop chance.
• color <dye>
  = sets the color of animal, only works for sheep and pet wolf; values can be found in ‘name index.html’ file at ‘DYE COLORS’ section.
• elder
  = sets a guardian as an elder
• feet <item> [drop%]
  = equip an item on the creature’s feet with optional drop chance.
• hand <item> [drop%]
  = equip an item on the creature’s hand with optional drop chance; for enderman it only uses material and data from the item.
• head <item> [drop%]
  = equip an item on the creature’s head with optional drop chance.
• hit
  = crafter will fake-attack the creature to provoke it into attacking or scare it away.
• haschest
  = adds a chest to creature (Only works on horses, forces horse to be an adult and tamed).
• horse <type>
  = set the horse type, values: horse, donkey, mule, undead_horse, skeleton_horse
• horsecolor <type>
  = set the horse color, values: white, creamy, chestnut, brown, black, gray, dark_brown
• horsestyle <type>
  = set the horse style, values: none, white, whitefield, white_dots, black_dots
• hp <health> [max]
  = set creature’s health and optionally max health.
• jumpstrength <0.0-2.0>
  = sets the creature’s jump strength (Only works for horses). 0 = no jump
• legs <item> [drop%]
  = equip an item on the creature’s legs with optional drop chance.
• mountnext
  = this creature will mount the next creature definition that triggers after it.
• noeffect
  = no spawning particle effects on creature.
• noremove
  = prevents creature from being removed if nobody is near it.
• name <text>
  = sets the creature’s name, supports colors (<red>, &3, etc).
• nobreed
  = prevent the creature being able to breed, works for animals and villagers.
• nohidename
  = don’t hide name plate when not aiming at creature.
• num <number>
  = spawn more cloned creatures.
• onfire <time>
  = spawn creature on fire for <time> amount of seconds, value can be float.
• pet [nosit]
  = makes creature owned by crafter, only works for wolf and ocelot, optionally specify ‘nosit’ to not spawn creature in sit stance.
• pickup [true/false]
  = change if creature can pick-up dropped items.
• playerirongolem
  = marks iron golem as player-made.
• potion <type> [time] [amp]
  = adds potion effect on the spawned creature; for <type> see ‘name index.html’ at ‘POTION EFFECT TYPE’; [time] can be a decimal of duration in seconds; [amp] can be an integer that defines amplifier; this argument can be used more than once to add more effects.
• poweredcreeper
  = makes creeper a powered one, only works for creepers.
• rabbit <type>
  = set the rabbit type, values: brown, white, black, black_and_white, gold, salt_and_pepper, the_killer_bunny
• saddle [mount]
  = adds saddle on creature (forces animal to be adult), only works for pig and horse, optionally you can specify ‘mount’ to make crafter mount creature.
• shearedsheep
  = sets the sheep as sheared, only works for sheep.
• skeleton <type>
  = set the skeleton type, values: normal, wither
• spread <range>
  = spawns creature(s) spread within block range instead of on top of workbench or furnace. (WARNING: can be CPU intensive)
• target
  = creature targets crafter, that means monsters attack and animals follow and the rest do nothing
• villager <type>
  = set the villager profession, values: farmer, librarian, priest, blacksmith, butcher
• zombievillager
  = makes zombie a zombie villager, only works on zombies.

These arguments can be used in any order and they’re all optional.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@summon cow
@summon skeleton | hand bow // skeletons spawn without weapons, you need to give it one
@summon zombie | zombievillager | baby | chest chainmail_chestplate 25% | legs chainmail_leggings 25% | hand iron_sword 50% // baby villager zombie warrior
@summon sheep | color pink | name <light_purple>Pony
@summon ocelot | cat redcat | pet | potion speed 30 5
// chicken on a villager and villager on a cow:
@summon chicken | mountnext
@summon villager | mountnext
@summon cow

Aliases: @spawn, @creature, @mob, @animal

---

^ Contents

@blockpowered [arguments]

Requires the workbench or furnace block to be powered by redstone.
作業台かかまどブロックにレッドストーンによるパワーを必要とします。

Optionally you can use the following arguments separated by | character and in any order:

indirect = check for indirect redstone power, through other blocks.
failmsg <message> = overwrite the failure message.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@blockpowered
@blockpowered failmsg <red><bold>YOU HAVE NO (indirect) POWAAH!!! | indirect

Aliases: @poweredblock, @blockpower, @redstonepowered

---

^ Contents

@potioneffect <effect type> | [arguments]
@potioneffect clear

Adds potion effects to crafter.
クラフターにポーション効果を追加。
This flag can be used more than once to add more effects.
このフラグは複数回使用することで複数の効果を付与することができます。

Using ‘clear’ will remove all potion effects from player before adding any defined ones.

The <effect type> argument must be an effect type, names for them can be found in ‘name index.html’ file at ‘POTION EFFECT TYPE’.

Optionally you can add more arguments separated by | character in any order:

• duration <float>
  持続時間 <浮動小数点>
  = (default 3.0) potion effect duration in seconds, only works on non-instant effect types.
  = (初期値は3.0)秒単位のポーション効果は、瞬間ではない種類のエフェクトタイプで動作します。
• amplifier <num>
  = (default 0) potion effect amplifier.
• chance <0.01-100>%
  = (default 100%) chance that the effect will be applied, this chance is individual for this effect.
• morefx = (default not set)
  more ambient particle effects, more screen intrusive.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@potioneffect clear // remove all player’s potion effects beforehand
@potioneffect heal
@potioneffect blindness | duration 60 | amplifier 5
@potioneffect poison | chance 6.66% | morefx | amplifier 666 | duration 6.66

Aliases: @potionfx

---

^ Contents

@launchfirework effect <effects>
@launchfirework power <number 0-128>

Launches a firework from workbench/player/furnace when recipe or result item is crafted.
レシピや結果が加工されたとき、作業台/プレイヤー/かまどから花火が発動します。
This flag can be defined multiple times add effects and set power to the same rocket.
このフラグは複数回効果を定義すると、同一のロケットにパワーを追加します。

The ‘effect’ setting adds an effect to the rocket.
Replace <effects> with the effects separated by | character.
Effects can be:

• color <red> <green> <blue>, …
  = (Required at least 1 color) Sets the primary explosion color(s), you can define more colors separated by comma.
• fadecolor <red> <green> <blue>, …
  = (Optional) Color(s) of the explosion fading, you can define more colors separated by comma.
• type <explode type>
  = (Optional) Shape/size of explosion, can be: BALL, BALL_LARGE, BURST, CREEPER or STAR… or see name index.html file.
• trail
  = (Optional) Adds a trail to the explosion
• flicker
  = (Optional) Adds a flicker to explosion

Effects can be listed in any order.
Colors must be 3 numbers ranging from 0 to 255, basic RGB format.

The ‘power <number 0-128>’ value sets how long rocket will fly, each number is 0.5 seconds, values above 4 are NOT recommended because it heavily affects client performance.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@launchfirework effect color 0 255 0
@launchfirework effect trail | color 255 0 0 | type burst
@launchfirework effect color 255 0 200, 0 255 0, 255 128 0 | trail | type ball_large | fadecolor 255 0 0, 0 0 255, 0 255 0
@launchfirework power 2

Aliases: @setfirework

---

^ Contents

@setblock <block material>:[data] | [arguments]

Changes the workbench/furnace/block-at-player into other block type.
作業台/かまど/プレイヤーの居るブロックの種類を変更します。
Using this flag more than once will overwrite the previous flag.
このフラグは複数使うと、前のフラグを上書きします。

Replace ‘<block material>’ with a block material (not item!), see ‘name index.html’ for list, IDs up to 255 are blocks, after that they’re items.
Optionally you can define a data value which defines its skin, direction and other stuff, see the ‘Minecraft Wiki / Data Values’ link from the ‘name index.html’ file.
You can also use aliases for materials and data values too.

Additionally you can define a set of arguments separated by | character:

• drop =
  breaks the existing block and drops its item.
• noinv [failmsg]
  = prevent inventory crafting, if this is not set, the flag will set the block at player location too; optionally you can overwrite the failure message for this condition.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@setblock gold_block
@setblock planks:jungle | noinv // set to jungle wood planks and prevent inventory crafting
@setblock air | drop | noinv <red>Only workbench! // simulate block break

Aliases: @changeblock

---

^ Contents

@message <text>

Prints a message when recipe or item is successfully crafted.
レシピやアイテムが正常に加工された時にメッセージを出します。
This flag can be used more than once to add more messages.
このフラグは複数回使用すると、複数のメッセージを出すことができます。

Colors are supported (<red>, &5, etc).
The message can also contain variables:

• {player}
  = crafter’s name or ‘(nobody)’ if not available
• {playerdisplay}
  = crafter’s display name or ‘(nobody)’ if not available
• {result}
  = the result item name or ‘(nothing)’ if recipe failed.
• {recipename}
  = recipe’s custom or autogenerated name or ‘(unknown)’ if not available
• {recipetype}
  = recipe type or ‘(unknown)’ if not available
• {inventorytype}
  = inventory type or ‘(unknown)’ if not available
• {world}
  = world name of event location or ‘(unknown)’ if not available
• {x}
  = event location’s X coord or ‘(?)’ if not available
• {y}
  = event location’s Y coord or ‘(?)’ if not available
• {z}
  = event location’s Z coord or ‘(?)’ if not available

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@message <green>Good job!
@message <gray>Now you can die&c happy<gray> that you crafted that.

Aliases: @craftmsg, @msg

---

^ Contents

@broadcast <text> | [permission]

Prints a chat message for all online players.
全てのオンラインプレーヤーのチャットにメッセージします。
Using this flag more than once will overwrite the previous message.
このフラグは一つ前のメッセージに上書きされます。

Optionally you can set a permission node that will define who sees the message.

Colors are supported (<red>, &5, etc).
The message can also contain variables:

• {player}
  = crafter’s name or ‘(nobody)’ if not available
• {playerdisplay}
  = crafter’s display name or ‘(nobody)’ if not available
• {result}
  = the result item name or ‘(nothing)’ if recipe failed.
• {recipename}
  = recipe’s custom or autogenerated name or ‘(unknown)’ if not available
• {recipetype}
  = recipe type or ‘(unknown)’ if not available
• {inventorytype}
  = inventory type or ‘(unknown)’ if not available
• {world}
  = world name of event location or ‘(unknown)’ if not available
• {x}
  = event location’s X coord or ‘(?)’ if not available
• {y}
  = event location’s Y coord or ‘(?)’ if not available
• {z}
  = event location’s Z coord or ‘(?)’ if not available

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@broadcast {playerdisplay} <green>crafted something!
@broadcast ‘{player}’ crafted ‘{recipename}’ at {world}: {x}, {y}, {z} | ranks.admins

Aliases: @announce, @msgall

---

^ Contents

@secret [true or false]

Hides the recipe or result from common info sources.
一般的な情報からレシピの結果を非表示にします。
Recipes are hidden from commands, books, etc.
レシピはコマンドやブックなどから隠されます。
Results are also hidden from commands, books and most importantly from multiresult item display.
コマンドの結果から本と最も重要な複数のアイテムの表示が隠されます。
This also means recipes/results won’t give out any fail craft reasons!

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@secret

Aliases: @hide

---

^ Contents

@temperature [operator]<number> | [fail message]

Checks if the crafter or furnace has at least ‘min’ temperature unless [operator] is set.
クラフターやかまどの温度をチェックします。
Using this flag more than once will overwrite the previous one.

The ‘[operator]’ argument can be nothing at all or you can use >= (which is the same as nothing, to check for greater than or equal), <= (less than or equal), > (greater), or < (less than).
The ‘<number>’ argument must be the temperature you want to check against. Uses doubles, meaning 1 and 1.0 are valid numbers.
The ‘[operator]<number>’ combination can be used multiple times when separated by a comma. In that case, all checks must be successful

Optionally you can overwrite the fail message or you can use ‘false’ to hide it.
In the message the following variables can be used:

• {temperature}
  = temperature conditions
• {actual}
  = the actual temperature player or furnace is at

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@temperature < 0 // Must be in an icy biome
@temperature 1.2 // Must be in a hot biome, such as a desert or savanna
@temperature >= 1.2 // Equivalent to the above example
@temperature >= .15, <= .95 // Must be within a temperature where it can rain

Aliases: @temp

---

RECIPE ONLY FLAGS
レシピのみのフラグ
Usable only on file headers or recipe headers. Can not be used on result items.
唯一のファイルヘッダやレシピのヘッダに使用出来る。結果には使用出来ません。

---

^ Contents

@addtobook <book title> [volume <num>]

This flag is a shortcut for quickly adding recipe(s) to books.
このフラグはショートカットで直ぐにレシピを本へ追加します。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

The book must exist first, you must create it, see ‘recipe books.html’ for how to do that.

The ‘<book title>’ argument must be an existing book’s name, partial matching can be used.
Optionally you can specify which volume to add it to, otherwise it will be added in its ‘recipes’ node and left to be added automatically to the latest volume with free slots.

NOTE: To properly remove recipes from books you must first remove this flag (to avoid re-adding them) then go to the book’s YML file and remove them from there as well.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@addtobook testingbook // can match a ‘Testing Book’ book for example
@addtobook random stuf volume 3 // can match a ‘Random Stuff volume 3’ book for example

Aliases: @recipebook

---

^ Contents

@failmessage [message or false]

Changes the message when recipe fails due to failure chance.
レシピが失敗の可能性が原因で失敗した時のメッセージを変更します。
Using this flag more than once will overwrite the previous message.
このフラグは一つ前のメッセージに上書きされます。

The message supports colors (<red>, &3, etc).

You can also use the following variables inside the message:

• {failchance}
  = recipe’s chance of failure as a number.
• {successchance}
  = recipe’s chance of success as a number.
• {resultchance}
  = result’s chance of success as a number.

The same effect can be achieved by using @message on the fail result item.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@failmessage <red>YOU FAILED, MWaHahahah!

Aliases: @failmsg

---

^ Contents

@displayresult <item or first> | [silentfail]

Sets the display result of the recipe.
レシピの結果表示を設定します。
Using this flag more than once will overwrite the previous message.
このフラグは一つ前のメッセージに上書きされます。

As ‘item’ argument you can define an item like in a result, material:data:amount.
Or you can set the item as ‘first’ to use the first display result available, very useful for multiple results having @ingredientcondition flag on them.

Optionally, using ‘silentfail’ argument you can make the recipe print no result if it wouldn’t give anything in the case of no results being allowed to craft (by other flags, like @ingredientcondition).

NOTE: If there is no item to be displayed (all are secret or unavailable), using this with ‘first’ will not do anything.
NOTE: Can only be used on workbench recipes because it can not have effect on other recipes.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@displayresult first // displays the first available result
@displayresult diamond_helmet:120 // damaged diamond helmet

Aliases: @resultdisplay, @showresult

---

^ Contents

@remove [true or false]

Removes an existing recipe that was added by vanilla Minecraft or other plugins/mods.
バニラのマインクラフト、あるいは他のプラグイン/Modで追加された既存のレシピを削除します。
The recipe definition must have the exact ingredients of the recipe you want to overwrite.
レシピの定義は上書きたいレシピの正確な材料を持っている必要があります。

Results and smelt time will be ignored and you don’t have to delete them if you want to keep them for later.

If you don’t know the exact ingredients you can use ‘rmextract’ command to extract all existing recipes in RecipeManager format.
Value is optional, if value is not specified it will just be enabled.

This can’t be used along with @override flag.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@remove

Aliases: @delete

---

^ Contents

@restrict [fail message]

Restricts the recipe to everybody.
レシピを制限します。
This is the player-friendly version of @remove because crafter gets a message when trying to craft the recipe.

Optionally you can overwrite the default restrict message.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@restrict
@restrict <red>Access denied!

Aliases: @disable, @denied, @deny

---

^ Contents

@override [true or false]

Overwrites an existing recipe from vanilla Minecraft or other plugins/mods.
バニラのマインクラフト、あるいは他のプラグイン/Modの既存のレシピを上書きます。
The recipe definition must have the exact ingredients of the recipe you want to overwrite.
レシピの定義は上書きたいレシピの正確な材料を持っている必要があります。

You may set whatever result(s) you want and add any other flags, this flag allows RecipeManager to take control over that recipe.
If you don’t know the exact ingredients you can use ‘rmextract’ command to extract all existing recipes in RecipeManager format.

Value is optional, if value is not specified it will just be enabled.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@override

Aliases: @edit, @overwrite, @supercede, @replace

---

RESULT ONLY FLAGS
結果のみのフラグ
Usable only on recipe’s result items. Can not be used on recipes or file header.
レシピの結果にのみ使用できます。レシピやファイルヘッダに使用することはできません。

---

^ Contents

@cloneingredient <arguments>

Clones the ingredient matching material of the result used on.
使用される結果の材料と一致する素材のクローン。
Using this flag more than once will overwrite the previous one.
このフラグは複数使うと、前のフラグを上書きします。

As ‘<arguments>’ you must define at least one feature to copy from the ingredient to the result.
Arguments can be one or more of the following, separated by | character:

• data [<mod> <value>]
  = copy data value with optional modifier, <mod> can be +,-,/,* or % as math operator and <value> a number.
• amount [<mod> <value>]
  = copy stack amount with optional modifier, <mod> can be +,-,/,* or % as math operator and <value> a number.
• enchants
  = copies the enchantments.
• name
  = copies the custom item name.
• lore
  = copies the custom item lore/description.
• special
  = copies item’s special feature like leather armor color, firework effects, book contents, skull owner, etc.
• allmeta
  = copies enchants, name, lore and special.
• all
  = copies entire item (data, amount, enchants, name, lore, special)

NOTE: If the result’s material is present in the ingredients more than once, when using the recipe it will clone the details of first item in the grid.

To apply conditions for ingredients (ranged data values, specific names, etc) then you can use the @ingredientcondition flag too.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@cloneingredient data // just copy data value
@cloneingredient data +2 // copy data value and add 2 to it
@cloneingredient amount * 2 // copy amount and multiply it by 2
@cloneingredient data % 2 // get the remainder from data divided by 2.
@cloneingredient data | amount | lore // only copy these things
@cloneingredient all // copy entire ingredient

Aliases: @clone, @copy, @copyingredient

---

^ Contents

@itemname <text or false>

Changes result’s display name.
結果の表示名を変更します。

Supports colors (e.g. <red>, <blue>, &4, &F, etc).

You can also use these variables:

• {player} = crafter’s name or ‘(nobody)’ if not available
• {playerdisplay} = crafter’s display name or ‘(nobody)’ if not available
• {result} = the result item name or ‘(nothing)’ if recipe failed.
• {recipename} = recipe’s custom or autogenerated name or ‘(unknown)’ if not available
• {recipetype} = recipe type or ‘(unknown)’ if not available
• {inventorytype} = inventory type or ‘(unknown)’ if not available
• {world} = world name of event location or ‘(unknown)’ if not available
• {x} = event location’s X coord or ‘(?)’ if not available
• {y} = event location’s Y coord or ‘(?)’ if not available
• {z} = event location’s Z coord or ‘(?)’ if not available

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@itemname <light_purple>Weird Item
@itemname <yellow>{player}’s Sword

Aliases: @name, @displayname

---

^ Contents

@itemlore <text>

Adds a line to result’s lore (description)
結果のlore(説明)に行を追加します。

Supports colors (e.g. <red>, <blue>, &4, &F, etc).

You can also use these variables:

• {player} = crafter’s name or ‘(nobody)’ if not available
• {playerdisplay} = crafter’s display name or ‘(nobody)’ if not available
• {result} = the result item name or ‘(nothing)’ if recipe failed.
• {recipename} = recipe’s custom or autogenerated name or ‘(unknown)’ if not available
• {recipetype} = recipe type or ‘(unknown)’ if not available
• {inventorytype} = inventory type or ‘(unknown)’ if not available
• {world} = world name of event location or ‘(unknown)’ if not available
• {x} = event location’s X coord or ‘(?)’ if not available
• {y} = event location’s Y coord or ‘(?)’ if not available
• {z} = event location’s Z coord or ‘(?)’ if not available

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@itemlore <red>Awesome item
@itemlore <magic>some scrambled text on line 2
@itemlore <gray>Crafted at {world}:{x},{y},{z}

Aliases: @lore, @itemdesc

---

^ Contents

@leathercolor <red> <green> <blue>

Changes result’s leather armor color, colors must be 3 numbers ranged from 0 to 255, the red, green and blue channels.
革鎧の色を変更します。色は0～255の範囲で、赤、緑、青の3つの数字をでなければなりません。

Specific items: leather armor.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@leathercolor 255 100 50

Aliases: @leathercolour, @color, @colour

---

^ Contents

@bookitem title [text]
@bookitem author [text]
@bookitem addpage [text]

Changes book’s contents.
本の内容を変更します。
Using this flag more than once will configure the same flag.

Supports colors and format (e.g. <red>, <blue>, &4, &F, etc).

Use ‘title <text>’ and ‘author <text>’ only on written books, it doesn’t work on book and quill therefore they’re optional.
Title and author must not exceed 64 characters, colors included (2 chars each).

Use ‘addpage <text>’ to add a new page, the text can contain \n to add new lines to it, but it mainly word-wraps itself.
Page contents must not exceed 256 characters, colors (2 chars each) and new line (1 char each) included.
Optionally you can leave the text blank to add a blank page.

Supported items: written book, book and quill.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@bookitem title The Art of Stealing
@bookitem author Gray Fox
@bookitem addpage <bold>O<reset>nce upon a time…
@bookitem addpage // added blank page
@bookitem addpage \n\n\n\n<italic> The End.

Aliases: @book

---

^ Contents

@fireworkitem effect <effect data>
@fireworkitem power <0-128>

Configures firework rocket’s effects.
ロケット花火のエフェクトを設定します。
Using this flag more than once will append changes to the item.

The ‘effect’ setting adds an effect to the rocket.
Replace ‘<effect arguments>’ with the following arguments separated by | character.
Effects can be:

• color <red> <green> <blue>, …
  = (Required) Sets the primary explosion color(s), you can define more colors separated by comma.
• fadecolor <red> <green> <blue>, …
  = (Optional) Color(s) of the explosion fading, you can define more colors separated by comma.
• type <explode type>
  = (Optional) Shape/size of explosion, can be: ball, ball_large, star, burst, creeper (see ‘name index.html’ file)
• trail
  = (Optional) Adds a trail to the explosion
• flicker
  = (Optional) Adds a flicker to explosion

Effects can be listed in any order.
Colors must be 3 numbers ranging from 0 to 255, basic RGB format.

The ‘power <number 0-128>’ value sets how long rocket will fly, each number is 0.5 seconds of flight, default 2, recommended max 4.

Specific item: firework.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@fireworkitem effect color 0 255 0
@fireworkitem effect trail | color 255 0 0 | type burst
@fireworkitem effect color 255 0 200, 0 255 0, 255 128 0 | trail | type ball_large | fadecolor 255 0 0, 0 0 255, 0 255 0
@fireworkitem power 1

Aliases: @firework, @fireworkrocket

---

^ Contents

@fireworkchargeitem <effect arguments>

Configures firework charge’s effect.
花火チャージのエフェクトを変更します。
Using this flag more than once will overwrite previous changes since the item only supports one effect.

Replace ‘<effect arguments>’ with the following arguments separated by | character.
Effects can be:

• color <red> <green> <blue>, …
  = (Required) Sets the primary explosion color(s), you can define more colors separated by comma.
• fadecolor <red> <green> <blue>, …
  = (Optional) Color(s) of the explosion fading, you can define more colors separated by comma.
• type <explode type>
  = (Optional) Shape/size of explosion, can be: ball, ball_large, star, burst, creeper (see ‘name index.html’ file)
• trail
  = (Optional) Adds a trail to the explosion
• flicker
  = (Optional) Adds a flicker to explosion

Effects can be listed in any order.
Colors must be 3 numbers ranging from 0 to 255, basic RGB format.

Specific item: firework_charge.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@fireworkchargeitem trail | color 255 0 0, 0 255 0 | type ball_large
@fireworkchargeitem type creeper | color 0 255 0 | fadecolor 255 0 0, 0 255 0 | flicker

Aliases: @fireworkcharge, @fireworkeffect

---

^ Contents

@skullowner <name>

Sets the human skull’s owner to apply the skin.
人の頭をオーナのスキンに設定します。
If you set it to ‘{player}’ then it will use crafter’s name.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@skullowner Notch
@skullowner {player}

Aliases: @skullitem

---

^ Contents

@potionitem <basic effect>
@potionitem custom <custom effect>

Builds a potion item, only works with POTION item.
ポーションアイテムの作業した場合、ポーションアイテムを作成します。

There are 2 types of potions… basic potions which have 1 effect and custom potions which can have multiple effects.

Building a basic potion:

Instead of <basic effect> argument you must enter a series of arguments separated by | character, in any order.
Arguments for basic effect:

• type <potion type>
  = (REQUIRED) Type of potion, read ‘name index.html’ at ‘POTION TYPES’ section (not POTION EFFECT TYPE!)
• level <number or max>
  = (optional) Potion’s level/tier, usually 1(default) or 2, you can enter ‘max’ to set it at highest supported level
• extended
  = (optional) Potion has extended duration
• splash
  = (optional) Throwable/breakable potion instead of drinkable

Building a custom potion requires adding individual effects:

A basic potion still affects the custom potion like the following:

•  If no basic potion is defined the bottle will look like ‘water bottle’ with no effects listed, effects still apply when drank
•  Basic potion’s type affects bottle liquid color
•  Basic potion’s splash still affects if the bottle is throwable instead of drinkable
•  Basic potion’s extended and level do absolutely nothing.
•  The first custom effect added is the potion’s name, rest of effects are in description (of course you can use @name to change the item name)

Once you understand that, you may use @potion custom as many times to add as many effects you want.

Similar syntax to basic effect, arguments separated by | character, can be in any order.
Arguments for custom effect:

• type <effect type>
  = (REQUIRED) Type of potion effect, read ‘name index.html’ at ‘POTION EFFECT TYPE’ section (not POTION TYPE !)
• duration <float>
  = (optional) Duration of the potion effect in seconds, default 1 (does not work on HEAL and HARM)
• amplify <number>
  = (optional) Amplify the effects of the potion, default 0 (e.g. 2 = <PotionName> III, numbers after potion’s max level will display potion.potency.number instead)
• ambient
  = (optional) Adds extra visual particles

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@potionitem level max | type FIRE_RESISTANCE | extended // basic extended fire resistance potion
// advanced potion example:
@potionitem type POISON | splash // set the bottle design and set it as splash
@potionitem custom type WITHER | duration 10 // add wither effect
@potionitem custom duration 2.5 | type BLINDNESS | amplify 5 // add blindness effect

Aliases: @potion

---

^ Contents

@enchantitem <enchantment> [level]

Enchants the result with the specified enchantment at specified level.
指定されたレベルのエンチャントを結果にエンチャントします。
You must specify an enchantment name, you can find all of them in ‘name index.html’ file at ‘ENCHANTMENTS LIST’ section.
Optionally you can set the level of enchantment, default is the enchantment’s start level or you can use ‘max’ to set it to enchantment’s max level.

Enchantments are forced and there is no level cap!
This flag may be used more times to add more enchantments to the item.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@enchantitem OXYGEN // enchant with oxygen at level 1
@enchantitem DIG_SPEED max // enchant with dig speed at max valid level
@enchantitem ARROW_INFINITE 127 // enchant with arrow infinite forced at level 127

Aliases: @enchant, @enchantment

---

^ Contents

@enchantedbook <enchant> [level or max]

Adds stored enchantments in a enchanted book item.
エンチャント本にエンチャントを追加します。
This flag may be used more times to add more enchantments to the item.

You must specify an enchantment name or id, you can find all of them in ‘name index.html’ file.
Optionally you can set the level of enchantment, default is the enchantment’s start level or you can use ‘max’ to set it to enchantment’s max level.

Enchantments are forced and there is no level cap!

Specific item: enchanted_book

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@enchantedbook efficiency // dig_speed alias
@enchantedbook damage_all max
@enchantedbook arrow_fire 127

Aliases: @enchantbook, @enchantingbook

---

^ Contents

@getrecipebook <book id> [volume <num>]

Overwrites result with the specified recipe book.
結果が指定されたレシピ本に上書きされます。

For the ‘<book id>’ argument you need to specify the book ID, case insensitive and partial matching supported.

Optionally you can set which volume to give, will give first by default, using a bigger number than the number of volumes will pick the last volume.

Setting to ‘false’ or ‘remove’ will disable the flag.

Examples:
@getrecipebook recipestu // matches a ‘Recipe Stuff.yml’ book for example.
@getrecipebook vanilla rec volume 2 // matches a ‘vanilla_recipes.yml’ with volume 2 for example.

Aliases: @getbook, @bookresult