/*@jsxRuntime automatic @jsxImportSource react*/ const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; function MDXContent(props = {}) { const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components); return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, { children: _jsx(_createMdxContent, {}) })) : _createMdxContent(); function _createMdxContent() { const _components = Object.assign({ h2: "h2", p: "p", strong: "strong", h3: "h3", pre: "pre", code: "code" }, _provideComponents(), props.components), {Highlight} = _components; if (!Highlight) _missingMdxReference("Highlight", true); return _jsxs(_Fragment, { children: [_jsx(_components.h2, { children: "First steps" }), "\n", _jsxs(_components.p, { children: ["When you're willing to use ", _jsx(_components.strong, { children: "MCEnchants" }), ", you first need to import it to your project."] }), "\n", _jsx(_components.h3, { children: "Importing with Maven" }), "\n", _jsx(Highlight, { language: "xml", children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-xml", children: "\n \n io.github.nedaras\n MCCEnchants\n 1.18.2-R0.1-SNAPSHOT\n provided\n \n\n" }) }) }), "\n", _jsx(_components.h3, { children: "Setting MCEnchants as dependency" }), "\n", _jsxs(_components.p, { children: ["Now you will have to put ", _jsx(_components.strong, { children: "MCEnchants" }), " as depend dependency in ", _jsx(_components.strong, { children: "plugin.yml" }), " file."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Example:" }) }), "\n", _jsx(Highlight, { language: "yaml", children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-yaml", children: "name: Enchantment\nversion: version\nauthor: author\nmain: your.plugin.path.here.Main\n\ndepend:\n - MCCEnchants\n" }) }) }), "\n", _jsxs(_components.p, { children: ["Congrats you successfully added ", _jsx(_components.strong, { children: "MCEnchants" }), " api to your plugin. Next we need to create and register a custom enchantment."] }), "\n", _jsx(_components.h2, { children: "Creating and Registering an custom enchantment" }), "\n", _jsxs(_components.p, { children: ["When you imported ", _jsx(_components.strong, { children: "MCEnchants" }), " api, lets try to use it and add you own enchantment.\nYou will be recreating telepathy's enchantment."] }), "\n", _jsx(_components.h3, { children: "Using MCCEnchantment wrapper" }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "MCCEnchants" }), " provides custom enchantment wrapper.\nSimilar like bukkit's Enchantment class, just provides more methods to customize."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Wrapper's Example:" }) }), "\n", _jsx(Highlight, { language: "java", children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-java", children: "import app.vercel.minecraftcustoms.mccenchants.api.enchantments.EnchantmentRarity;\nimport app.vercel.minecraftcustoms.mccenchants.api.enchantments.MCCEnchantment;\nimport app.vercel.minecraftcustoms.mccenchants.api.enchantments.MCCEnchantmentConfig;\nimport org.bukkit.NamespacedKey;\nimport org.bukkit.enchantments.EnchantmentTarget;\nimport org.bukkit.inventory.ItemStack;\nimport org.bukkit.plugin.java.JavaPlugin;\nimport org.jetbrains.annotations.NotNull;\n\n// this api is like paper's Enchantment api\npublic class Telepathy extends MCCEnchantment {\n\n // configuration that can be created if you want to add some setting tu your plugin.\n // if you're winningly to use this config check next step how to create \"your enchantment's namespace key\".yml\n private final MCCEnchantmentConfig config;\n\n public Telepathy(@NotNull NamespacedKey key, @NotNull JavaPlugin plugin) {\n super(key);\n config = new MCCEnchantmentConfig(key, plugin);\n\n }\n\n @Override\n public @NotNull String getDisplayName() {\n // custom config in use for custom name.\n return config.getDisplayName();\n\n }\n\n @Override\n public @NotNull String getName() {\n return \"TELEPATHY\";\n }\n\n @Override\n public int getMaxLevel() {\n return 1;\n }\n\n @Override\n public int getStartLevel() {\n return 1;\n }\n\n @Override\n public @NotNull EnchantmentRarity getRarity() {\n return config.getEnchantmentRarity();\n }\n\n @Override\n public int getMinCost(int level) {\n return MCCEnchantment.SILK_TOUCH.getMinCost(level);\n }\n\n @Override\n public int getMaxCost(int level) {\n return MCCEnchantment.SILK_TOUCH.getMaxCost(level);\n }\n\n @Override\n public @NotNull EnchantmentTarget getItemTarget() {\n return EnchantmentTarget.TOOL;\n }\n\n @Override\n public boolean isTreasure() {\n return false;\n }\n\n @Override\n public boolean isCursed() {\n return false;\n }\n\n @Override\n public boolean isTradable() {\n return false;\n }\n\n @Override\n public boolean isDiscoverable() {\n return true;\n }\n\n @Override\n public boolean conflictsWith(@NotNull MCCEnchantment mccEnchantment) {\n return !mccEnchantment.equals(this);\n }\n\n @Override\n public boolean canEnchantItem(@NotNull ItemStack itemStack) {\n return getItemTarget().includes(itemStack);\n }\n}\n" }) }) }), "\n", _jsx(_components.h3, { children: "Creating \"your enchantment's namespace key\".yml for enchantments configuration" }), "\n", _jsxs(_components.p, { children: ["First you will have to create a yaml file at the location of your ", _jsx(_components.strong, { children: "plugin.yml" }), " file with a name of your enchantment's namespace key(in this case ", _jsx(_components.strong, { children: "telepathy.yml" }), ")."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Example:" }) }), "\n", _jsx(Highlight, { language: "yaml", children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-yaml", children: "displayName: 'Telepathy'\nrarity: 'UNCOMMON'\n" }) }) }), "\n", _jsx(_components.h3, { children: "Registering your custom enchantment" }), "\n", _jsxs(_components.p, { children: ["It's very simple just call ", _jsx(_components.strong, { children: "registerEnchantment()" }), " at your plugins ", _jsx(_components.strong, { children: "onEnable" }), " method.\nAnd everything else will be handled by MCEnchants."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Example:" }) }), "\n", _jsx(Highlight, { language: "java", children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-java", children: "import app.vercel.minecraftcustoms.mccenchants.api.enchantments.MCCEnchantment;\nimport org.bukkit.NamespacedKey;\nimport org.bukkit.plugin.java.JavaPlugin;\n\npublic final class Main extends JavaPlugin {\n\n // we wan't to have this var in Main class\n // se we could later check if item has and telepathy enchantment.\n \n private MCCEnchantment telepathy;\n\n @Override\n public void onEnable() {\n\n telepathy = new Telepathy(NamespacedKey.minecraft(\"telepathy\"), this);\n MCCEnchantment.registerEnchantment(telepathy);\n\n }\n}\n" }) }) }), "\n", _jsxs(_components.p, { children: ["Start your minecraft server and the console should say ", _jsx(_components.strong, { children: "\"[INFO][MCEnchants] Registered enchantment: Telepathy\"" }), ".\nIf MCEnchants could't register the enchantment report the bug at ..."] }), "\n", _jsx(_components.h2, { children: "Add custom functionality to your enchantment" }), "\n", _jsx(_components.p, { children: "There is no use to create enchantment that does nothing, then lets add some functionality." }), "\n", _jsx(Highlight, { language: "java", children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-java", children: "import app.vercel.minecraftcustoms.mccenchants.api.enchantments.MCCEnchantment;\nimport app.vercel.minecraftcustoms.mccenchants.api.helpers.MCCEnchanting;\nimport app.vercel.minecraftcustoms.mccenchants.api.helpers.MCCInventory;\nimport org.bukkit.GameMode;\nimport org.bukkit.NamespacedKey;\nimport org.bukkit.event.EventHandler;\nimport org.bukkit.event.EventPriority;\nimport org.bukkit.event.Listener;\nimport org.bukkit.event.block.BlockBreakEvent;\nimport org.bukkit.inventory.ItemStack;\nimport org.bukkit.plugin.java.JavaPlugin;\n\nimport java.util.Collection;\n\npublic final class Main extends JavaPlugin implements Listener {\n\n private MCCEnchantment telepathy;\n\n @Override\n public void onEnable() {\n\n telepathy = new Telepathy(NamespacedKey.minecraft(\"telepathy\"), this);\n MCCEnchantment.registerEnchantment(telepathy);\n\n this.getServer().getPluginManager().registerEvents(this, this);\n\n }\n\n @EventHandler ( priority = EventPriority.HIGH )\n public void onBlockBreakEvent(BlockBreakEvent event) {\n \n // if there's isin't any dropped items we shouldn't do anything\n // otherwise it might broke with other custom enchantments that don't want to drop any items\n if (!event.isDropItems()) return;\n if (event.getPlayer().getGameMode() != GameMode.SURVIVAL) return;\n if (!MCCEnchanting.containsEnchantment(event.getPlayer().getInventory().getItemInMainHand(), telepathy)) return;\n\n Collection drops = event.getBlock().getDrops(event.getPlayer().getInventory().getItemInMainHand());\n\n // MCEnchantment's utility function to safely add item to the inventory.\n // When there is no space it will just drop the item on the given location.\n // NOTE: if location is not specified the item will be thrown out from player's head location.\n\n drops.forEach((drop) -> MCCInventory.saveAddItemToInventory(event.getPlayer(), event.getBlock().getLocation(), drop));\n\n event.setDropItems(false);\n\n }\n\n}\n" }) }) }), "\n", _jsxs(_components.p, { children: ["Now try out your enchantment by breaking block in ", _jsx(_components.strong, { children: "survival" }), " mode. It should teleport all items to your inventory, but if there is no space in your inventory the item will drop on the braked location caused by ", _jsx(_components.strong, { children: "saveAddToInventory" }), "."] }), "\n", _jsx(_components.h2, { children: "Some last words" }), "\n", _jsx(_components.p, { children: "Sorry for crapy documentation, it will be improved like this website and plugins.-\nI wan't to release my plugin as possible as i can and then make everything fancy." })] }); } } return { default: MDXContent }; function _missingMdxReference(id, component) { throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it."); }