メインコンテンツまでスキップ

fast_crafting

Fast Crafting - action entry.

Entry Information

PropertyValue
Entry IDfast_crafting
TypeAction
ColorYellow
Iconmaterial-symbols:add-row-above

Description

This action opens a server-authoritative fast crafting menu through the GuiAndDialogs API. Existing pages keep the legacy layoutPool/recipeGrid mode while integratedMenu.enabled opts into the one-inventory Crafting/Recipes menu. The integrated menu does not open a nested workbench, add a close button or place catalogue recipes into the matrix.

Legacy button markers are open_grid, refresh, page_prev, page_next, craft_amount and close. They remain available only for legacy layouts; integrated navigation is rendered by the menu itself.

Fields

FieldTypeDescription
inventoryTitleVar<String>Title of the inventory.
inventoryRowsIntNumber of rows (1-6).
guiTypeGuiTypeGUI type to use.
layoutPoolList<LayoutData>Static decorations and button markers.
mainLayoutIdString?ID of the main layout to display from the pool.
recipeGridRecipeGridConfigPosition and dimensions of the dynamic recipe grid.
classicCraftingClassicCraftingConfigOptional temporary 3x3 crafting matrix and output position.
craftAmountButtonCraftAmountButtonConfigCraft quantity selector.
integratedMenuIntegratedMenuConfigSingle-inventory tabs, quick-craft row, categories, counters, search, sort, filters and pagination.
dropWhenInventoryFullBooleanDrop crafted-result overflow.
autoRefreshTicksIntRe-render interval in ticks (0 disables it).
allowShiftCraftAllBooleanAllow shift-click bulk crafting.
fastCraftPermissionStringPermission required to use the GUI.
recipeNamespaceStringRecipe namespace filter; blank means all namespaces.
disableVanillaRecipesBooleanExclude minecraft: recipes.
useMMOItemsRecipesBooleanAdd MMOItems station recipes when available.
craftCooldownTicksIntCooldown between crafts in ticks.
audioGuiAudioDataGUI audio configuration.

IntegratedMenuConfig

FieldTypeDefaultDescription
enabledBooleanfalseEnable the one-inventory menu.
quickCraftPermissionStringfastcrafting.quickcraftPermission required to display row 2 quick crafting. Blank means visible to everyone.
defaultTabIntegratedTabCRAFTINGInitial tab.
defaultSortIntegratedSortAVAILABLE_FIRSTAvailability-first or alphabetical ordering.
defaultFilterIntegratedFilterALLShow all, available or missing recipes.
quickRecipesPerPageInt8Quick-craft items visible on row 2.
recipesPerPageInt27Catalogue items visible on rows 3-5.
categoryIdsList<String>Custom: 9 RPGCORE IDs; public: craftingCategories shown on the Recipes tab.
searchEnabledBooleantrueEnable Paper Dialog recipe search.

Runtime contract

The public artifact targets Java 21 bytecode and official Typewriter/Paper/GuiAndDialogs. The BTC custom artifact targets Java 25 and integrates with BTC Core/RPGCORE profession metadata and BtcCraftingRegistry. Craft commands are scoped to the active menu session; no global Bukkit command is registered. Inventory changes invalidate the per-player recipe projection. Classic-grid inputs are session memory and are always returned safely when the menu closes.