[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FX3KVK74TY64YAND01DJC":3,"skill-same:01M74FX3KVK74TY64YAND01DJC":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M74FX3KVK74TY64YAND01DJC","minecraft-testing",null,"Write automated tests for Minecraft mods and plugins for 1.21.x. Covers NeoForge GameTests (@GameTest annotation, GameTestHelper assertions, test structure placement), Fabric game tests (fabric-gametest-api-v1), unit testing non-Minecraft logic with JUnit 5, MockBukkit for Paper\u002FBukkit plugin testing (mock server, mock player, event dispatching, inventory checking), integration testing with a test server via Gradle, and GitHub Actions CI workflows that run GameTests headlessly. Includes patterns for mocking registries, testing event handlers, testing commands, and test-driven development for Minecraft projects. Use when the user asks about testing Minecraft mods or plugins, writing GameTests, setting up MockBukkit, or configuring CI for Minecraft projects.","AIKUSAN\u002Fminecraft-agent-skills-bundle","AIKUSAN","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F54048610?v=4","01M74FG91YZ75JDYZ7PNHER2NJ","Lorenz Tazan","01M74FG931PS45HBP26RKEZQDT",12,"MIT","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-testing\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: minecraft-testing\ndescription: \"Write automated tests for Minecraft mods and plugins for 1.21.x. Covers NeoForge GameTests (@GameTest annotation, GameTestHelper assertions, test structure placement), Fabric game tests (fabric-gametest-api-v1), unit testing non-Minecraft logic with JUnit 5, MockBukkit for Paper\u002FBukkit plugin testing (mock server, mock player, event dispatching, inventory checking), integration testing with a test server via Gradle, and GitHub Actions CI workflows that run GameTests headlessly. Includes patterns for mocking registries, testing event handlers, testing commands, and test-driven development for Minecraft projects. Use when the user asks about testing Minecraft mods or plugins, writing GameTests, setting up MockBukkit, or configuring CI for Minecraft projects.\"\n---\n\n# Minecraft Testing Skill\n\n## Testing Strategies Overview\n\n| Approach | Best For | Requires Game? |\n|----------|---------|----------------|\n| **JUnit 5** (pure unit tests) | Logic, data structures, NBT serialization | No |\n| **MockBukkit** | Bukkit\u002FPaper plugin events, commands, inventory | No (mocked server) |\n| **NeoForge GameTests** | In-game block\u002Fentity\u002Fworld interaction | Yes (test environment) |\n| **Fabric GameTests** | In-game block\u002Fentity\u002Fworld interaction | Yes (test environment) |\n| **Integration server** | Full plugin\u002Fmod lifecycle | Yes (dedicated test server) |\n\n### Routing Boundaries\n- `Use when`: the task is designing or implementing automated tests (unit, mock, gametest, CI test jobs) for Minecraft projects.\n- `Do not use when`: the task is implementing gameplay features rather than testing them (`minecraft-modding`, `minecraft-plugin-dev`, `minecraft-datapack`).\n- `Do not use when`: the task is release automation or publishing pipelines (`minecraft-ci-release`).\n- `Do not use when`: the task is a bot playthrough of a live dev server rather than code-level tests (`minecraft-bot-qa`).\n\n## Bundled References And Helpers\n\n- Layout guide: `references\u002Ftest-layouts.md`\n- Fixture\u002Flayout validator: `.\u002Fscripts\u002Fvalidate-test-layout.sh --root \u003Cproject>`\n\nUse the validator before copying a test layout into a real project. It checks for\nthe common breakpoints that show up in 1.21.x plugin\u002Fmod test repos: missing\n`useJUnitPlatform()`, MockBukkit tests without the dependency, and GameTests with\nno committed structure fixtures.\n\n---\n\n## Unit Testing (JUnit 5 — No Minecraft)\n\n### `build.gradle.kts` additions\n```kotlin\ndependencies {\n    testImplementation(\"org.junit.jupiter:junit-jupiter:5.11.0\")\n    testRuntimeOnly(\"org.junit.platform:junit-platform-launcher\")\n}\n\ntasks.test {\n    useJUnitPlatform()\n    testLogging {\n        events(\"passed\", \"skipped\", \"failed\")\n    }\n}\n```\n\n### Example pure unit test\n```java\nimport org.junit.jupiter.api.Test;\nimport static org.junit.jupiter.api.Assertions.*;\n\nclass CooldownManagerTest {\n\n    @Test\n    void playerOnCooldown_returnsFalse_afterExpiry() {\n        var manager = new CooldownManager(500L); \u002F\u002F 500ms cooldown\n        manager.startCooldown(\"steve\");\n        assertTrue(manager.isOnCooldown(\"steve\"));\n        \u002F\u002F fast-forward time by sleeping or injecting a Clock\n        assertFalse(manager.isOnCooldown(\"notExisting\"));\n    }\n\n    @Test\n    void cooldown_throwsIllegalArgument_onNegativeDuration() {\n        assertThrows(IllegalArgumentException.class,\n            () -> new CooldownManager(-1L));\n    }\n}\n```\n\n---\n\n## MockBukkit (Paper\u002FBukkit Plugin Tests)\n\n### `build.gradle.kts`\n```kotlin\nrepositories {\n    maven(\"https:\u002F\u002Frepo.papermc.io\u002Frepository\u002Fmaven-public\u002F\")\n    maven(\"https:\u002F\u002Frepo.mockbukkit.org\u002Fartifactory\u002Fmockbukkit\u002F\")\n}\n\ndependencies {\n    compileOnly(\"io.papermc.paper:paper-api:26.2.build.+\")\n    testImplementation(\"org.junit.jupiter:junit-jupiter:5.11.0\")\n    testImplementation(\"com.github.seeseemelk:MockBukkit-v1.21:3.127.0\")\n    testRuntimeOnly(\"org.junit.platform:junit-platform-launcher\")\n}\n\ntasks.test {\n    useJUnitPlatform()\n}\n```\n\n### Setup \u002F teardown pattern\n```java\nimport be.seeseemelk.mockbukkit.MockBukkit;\nimport be.seeseemelk.mockbukkit.ServerMock;\nimport be.seeseemelk.mockbukkit.entity.PlayerMock;\nimport org.junit.jupiter.api.*;\n\nclass MyPluginTest {\n\n    private static ServerMock server;\n    private static MyPlugin plugin;\n\n    @BeforeAll\n    static void setUp() {\n        \u002F\u002F Start mock Bukkit server and load your plugin\n        server = MockBukkit.mock();\n        plugin = MockBukkit.load(MyPlugin.class);\n    }\n\n    @AfterAll\n    static void tearDown() {\n        MockBukkit.unmock();\n    }\n}\n```\n\n### Testing events\n```java\n@Test\nvoid playerJoin_getsWelcomeMessage() {\n    PlayerMock player = server.addPlayer(\"Steve\");\n    player.simulateJoin(); \u002F\u002F fires PlayerJoinEvent\n\n    \u002F\u002F Assert the player received the expected message component\n    player.assertSaid(\"Welcome, Steve!\");\n    \u002F\u002F Or for Adventure components:\n    assertTrue(player.nextMessage().contains(\"Welcome\"));\n}\n\n@Test\nvoid onBlockBreak_cancelledForNonOp() {\n    PlayerMock player = server.addPlayer();\n    player.setOp(false);\n\n    Block block = player.getWorld().getBlockAt(0, 64, 0);\n    block.setType(Material.STONE);\n    BlockBreakEvent event = new BlockBreakEvent(block, player);\n    server.getPluginManager().callEvent(event);\n\n    assertTrue(event.isCancelled(), \"Non-op should not be able to break blocks\");\n}\n```\n\n### Testing commands\n```java\n@Test\nvoid mypluginInfo_returnsVersion() {\n    PlayerMock player = server.addPlayer(\"Admin\");\n    player.setOp(true);\n\n    boolean result = server.dispatchCommand(player, \"myplugin info\");\n\n    assertTrue(result);\n    player.assertSaid(\"Version: \" + plugin.getDescription().getVersion());\n}\n\n@Test\nvoid mypluginReload_requiresOp() {\n    PlayerMock player = server.addPlayer(\"NonOp\");\n    player.setOp(false);\n\n    server.dispatchCommand(player, \"myplugin reload\");\n\n    player.assertSaid(\"No permission.\");\n}\n```\n\n### Testing inventory \u002F items\n```java\n@Test\nvoid giveKitCommand_givesPlayerItems() {\n    PlayerMock player = server.addPlayer();\n    \n    server.dispatchCommand(player, \"kit starter\");\n    \n    \u002F\u002F Check inventory\n    assertTrue(player.getInventory().contains(Material.STONE_SWORD));\n    assertTrue(player.getInventory().contains(Material.BREAD, 16));\n}\n```\n\n### Testing scheduler tasks\n```java\n@Test\nvoid repeatingTask_firesAfterDelay() {\n    PlayerMock player = server.addPlayer();\n    \n    \u002F\u002F Execute 40 ticks worth of scheduled tasks\n    server.getScheduler().performTicks(40L);\n    \n    \u002F\u002F Assert expected side effect happened\n    assertEquals(2, plugin.getTaskCount());\n}\n```\n\n### Testing Folia-safe scheduler abstractions\n\nMockBukkit does not emulate Folia's region-threaded runtime. The safe pattern is to\nwrap scheduling behind your own interface and unit test the abstraction boundary.\n\n```java\ninterface SchedulerFacade {\n    void runPlayerTask(Player player, Runnable task);\n    void runAsync(Runnable task);\n}\n\n@Test\nvoid playerTask_delegatesThroughFacade() {\n    List\u003CString> calls = new ArrayList\u003C>();\n    SchedulerFacade facade = new SchedulerFacade() {\n        @Override\n        public void runPlayerTask(Player player, Runnable task) {\n            calls.add(\"player\");\n            task.run();\n        }\n\n        @Override\n        public void runAsync(Runnable task) {\n            calls.add(\"async\");\n            task.run();\n        }\n    };\n\n    facade.runPlayerTask(server.addPlayer(), () -> calls.add(\"ran\"));\n    assertEquals(List.of(\"player\", \"ran\"), calls);\n}\n```\n\n### Testing PDC\n```java\n@Test\nvoid pdcKillCount_incrementsOnKill() {\n    PlayerMock player = server.addPlayer();\n    NamespacedKey key = new NamespacedKey(plugin, \"kills\");\n    \n    \u002F\u002F Simulate kill event\n    EntityDeathEvent deathEvent = new EntityDeathEvent(\n        server.addMockEntity(EntityType.ZOMBIE), new ArrayList\u003C>(), 0\n    );\n    deathEvent.getEntity().setKiller(player);\n    server.getPluginManager().callEvent(deathEvent);\n    \n    int kills = player.getPersistentDataContainer()\n        .getOrDefault(key, PersistentDataType.INTEGER, 0);\n    assertEquals(1, kills);\n}\n```\n\n### Testing item or chunk PDC writes\n```java\n@Test\nvoid itemPdc_roundTripsCustomId() {\n    NamespacedKey key = new NamespacedKey(plugin, \"custom_id\");\n    ItemStack item = new ItemStack(Material.STICK);\n\n    item.editMeta(meta -> meta.getPersistentDataContainer().set(\n        key, PersistentDataType.STRING, \"wand\"\n    ));\n\n    String value = item.getItemMeta().getPersistentDataContainer()\n        .get(key, PersistentDataType.STRING);\n    assertEquals(\"wand\", value);\n}\n```\n\n---\n\n## NeoForge GameTests\n\nGameTests run inside a Minecraft world. They place a **structure** (the test environment),\nthen run assertions using `GameTestHelper`.\n\n### Registration\n```java\n\u002F\u002F In your mod main class:\n@Mod(MyMod.MOD_ID)\npublic class MyMod {\n    public MyMod(IEventBus modEventBus) {\n        modEventBus.register(MyGameTests.class);\n    }\n}\n```\n\n### Test class\n```java\nimport net.minecraft.gametest.framework.*;\nimport net.neoforged.neoforge.gametest.GameTestHolder;\nimport net.neoforged.neoforge.gametest.PrefixGameTestTemplate;\n\n@GameTestHolder(MyMod.MOD_ID)                \u002F\u002F registers test namespace\n@PrefixGameTestTemplate(false)               \u002F\u002F don't prefix template names\npublic class MyGameTests {\n\n    \u002F\u002F Default template: 3x3x3 air structure called \"mymod:empty\"\n    @GameTest(template = \"mymod:empty\")\n    public static void testBlockInteraction(GameTestHelper helper) {\n        \u002F\u002F Place a block\n        helper.setBlock(1, 1, 1, net.minecraft.world.level.block.Blocks.FURNACE);\n        \n        \u002F\u002F Run after 1 tick\n        helper.runAfterDelay(1, () -> {\n            \u002F\u002F Assert block state\n            helper.assertBlock(new net.minecraft.core.BlockPos(1, 1, 1),\n                b -> b.is(net.minecraft.world.level.block.Blocks.FURNACE),\n                \"Expected furnace\");\n            \n            helper.succeed();\n        });\n    }\n\n    @GameTest(template = \"mymod:empty\", timeoutTicks = 200)\n    public static void testEntitySpawn(GameTestHelper helper) {\n        \u002F\u002F Spawn entity\n        var entity = helper.spawnWithNoFreeWill(\n            net.minecraft.world.entity.EntityType.ZOMBIE, new net.minecraft.core.BlockPos(2, 2, 2)\n        );\n        \n        helper.runAfterDelay(5, () -> {\n            helper.assertEntityPresent(\n                net.minecraft.world.entity.EntityType.ZOMBIE,\n                new net.minecraft.core.BlockPos(2, 2, 2), 1.0\n            );\n            helper.succeed();\n        });\n    }\n}\n```\n\n### Structure templates (`.nbt` files)\nPlace empty structure files at:  \n`src\u002Fmain\u002Fresources\u002Fdata\u002Fmymod\u002Fstructures\u002Fempty.nbt`\n\nGenerate them in-game using `\u002Ftest create mymod:empty 3 3 3` (NeoForge test command).\nCommit the `.nbt` files to version control.\n\n### GameTest setup checklist\n\n1. Verify `.nbt` structure files exist at `src\u002Fmain\u002Fresources\u002Fdata\u002F\u003Cmodid>\u002Fstructures\u002F`\n2. Run `.\u002Fgradlew runGameTestServer` — if tests fail with \"Missing template\", the `.nbt` file path or name is wrong\n3. Check Gradle output for `PASSED`\u002F`FAILED` per test\n4. If a test times out, increase `timeoutTicks` in the `@GameTest` annotation or add intermediate assertions with `runAfterDelay`\n\n### Running GameTests\n```bash\n.\u002Fgradlew runGameTestServer\n\n# In-game (dev environment):\n# \u002Ftest runall\n# \u002Ftest run mymod:test_block_interaction\n```\n\n---\n\n## Fabric GameTests\n\n```java\nimport net.fabricmc.fabric.api.gametest.v1.FabricGameTest;\nimport net.minecraft.core.BlockPos;\nimport net.minecraft.gametest.framework.GameTest;\nimport net.minecraft.gametest.framework.GameTestHelper;\nimport net.minecraft.world.level.block.Blocks;\n\npublic class MyFabricGameTests implements FabricGameTest {\n\n    @GameTest(template = EMPTY_STRUCTURE)\n    public void testCustomBlock(GameTestHelper helper) {\n        helper.setBlock(1, 1, 1, Blocks.GOLD_BLOCK.defaultBlockState());\n        \n        helper.runAfterDelay(2, () -> {\n            helper.assertBlock(\n                new BlockPos(1, 1, 1),\n                b -> b.is(Blocks.GOLD_BLOCK),\n                \"Gold block should be placed\"\n            );\n            helper.succeed();\n        });\n    }\n}\n```\n\n### Register in `fabric.mod.json`\n```json\n{\n  \"entrypoints\": {\n    \"fabric-gametest\": [\n      \"com.example.mymod.fabric.MyFabricGameTests\"\n    ]\n  }\n}\n```\n\n---\n\n## `GameTestHelper` Assertions Reference\n\n```java\n\u002F\u002F Block assertions\nhelper.assertBlock(pos, predicate, \"message\");\nhelper.assertBlockState(pos, state -> state.is(Blocks.STONE), \"Expected stone\");\nhelper.assertBlockPresent(Blocks.GOLD_BLOCK, pos);\nhelper.assertBlockNotPresent(Blocks.TNT, pos);\n\n\u002F\u002F Entity assertions\nhelper.assertEntityPresent(EntityType.ZOMBIE, pos, radius);\nhelper.assertEntityNotPresent(EntityType.ZOMBIE);\nhelper.assertEntityCount(EntityType.ZOMBIE, expectedCount);\nhelper.assertEntityProperty(entity, entity -> entity.getHealth() > 0, \"alive\");\n\n\u002F\u002F Item assertions\nhelper.assertContainerContains(pos, Items.DIAMOND);\nhelper.assertContainerEmpty(pos);\n\n\u002F\u002F Control flow\nhelper.succeed();        \u002F\u002F mark test as passed — REQUIRED at end\nhelper.fail(\"reason\");   \u002F\u002F mark test as failed\nhelper.runAfterDelay(ticks, runnable); \u002F\u002F schedule assertion\nhelper.onEachTick(runnable);          \u002F\u002F run every tick (use with care)\nhelper.succeedWhen(() -> { \u002F* assertions *\u002F }); \u002F\u002F poll until assertions pass or timeout\nhelper.succeedOnTickWhen(tick, () -> { \u002F* assertions *\u002F });\n```\n\n---\n\n## CI: Running Tests in GitHub Actions\n\nSplit CI into fast unit\u002Fmock coverage and slower runtime-facing jobs. MockBukkit is great\nfor command\u002Fevent logic, but it does not prove Folia thread safety or real server bootstrap.\n\n```yaml\n# .github\u002Fworkflows\u002Ftest.yml\nname: Tests\n\non: [push, pull_request]\n\njobs:\n    unit-tests:\n        runs-on: ubuntu-latest\n        steps:\n            - uses: actions\u002Fcheckout@v4\n            - { uses: actions\u002Fsetup-java@v4, with: { java-version: '21', distribution: 'temurin' } }\n            - uses: gradle\u002Factions\u002Fsetup-gradle@v3\n            - { name: Run unit tests, run: .\u002Fgradlew test }\n\n    game-tests:\n        runs-on: ubuntu-latest\n        steps:\n            - uses: actions\u002Fcheckout@v4\n            - { uses: actions\u002Fsetup-java@v4, with: { java-version: '21', distribution: 'temurin' } }\n            - uses: gradle\u002Factions\u002Fsetup-gradle@v3\n            - { name: Run GameTests (headless), run: .\u002Fgradlew runGameTestServer, env: { CI: true } }\n\n    layout-checks:\n        runs-on: ubuntu-latest\n        steps:\n            - uses: actions\u002Fcheckout@v4\n            - { name: Validate test layout, run: .\u002Fscripts\u002Fvalidate-test-layout.sh --root . }\n```\n\n---\n\n## References\n\n- MockBukkit GitHub: https:\u002F\u002Fgithub.com\u002FMockBukkit\u002FMockBukkit\n- MockBukkit docs: https:\u002F\u002Fmockbukkit.readthedocs.io\u002F\n- NeoForge GameTest docs: https:\u002F\u002Fdocs.neoforged.net\u002Fdocs\u002Fmisc\u002Fgametest\u002F\n- Fabric GameTest API: https:\u002F\u002Fwiki.fabricmc.net\u002Ftutorial:gametests\n- JUnit 5 user guide: https:\u002F\u002Fjunit.org\u002Fjunit5\u002Fdocs\u002Fcurrent\u002Fuser-guide\u002F\n","# Minecraft Testing Skill\n\n## Testing Strategies Overview\n\n| Approach | Best For | Requires Game? |\n|----------|---------|----------------|\n| **JUnit 5** (pure unit tests) | Logic, data structures, NBT serialization | No |\n| **MockBukkit** | Bukkit\u002FPaper plugin events, commands, inventory | No (mocked server) |\n| **NeoForge GameTests** | In-game block\u002Fentity\u002Fworld interaction | Yes (test environment) |\n| **Fabric GameTests** | In-game block\u002Fentity\u002Fworld interaction | Yes (test environment) |\n| **Integration server** | Full plugin\u002Fmod lifecycle | Yes (dedicated test server) |\n\n### Routing Boundaries\n- `Use when`: the task is designing or implementing automated tests (unit, mock, gametest, CI test jobs) for Minecraft projects.\n- `Do not use when`: the task is implementing gameplay features rather than testing them (`minecraft-modding`, `minecraft-plugin-dev`, `minecraft-datapack`).\n- `Do not use when`: the task is release automation or publishing pipelines (`minecraft-ci-release`).\n- `Do not use when`: the task is a bot playthrough of a live dev server rather than code-level tests (`minecraft-bot-qa`).\n\n## Bundled References And Helpers\n\n- Layout guide: `references\u002Ftest-layouts.md`\n- Fixture\u002Flayout validator: `.\u002Fscripts\u002Fvalidate-test-layout.sh --root \u003Cproject>`\n\nUse the validator before copying a test layout into a real project. It checks for\nthe common breakpoints that show up in 1.21.x plugin\u002Fmod test repos: missing\n`useJUnitPlatform()`, MockBukkit tests without the dependency, and GameTests with\nno committed structure fixtures.\n\n---\n\n## Unit Testing (JUnit 5 — No Minecraft)\n\n### `build.gradle.kts` additions\n```kotlin\ndependencies {\n    testImplementation(\"org.junit.jupiter:junit-jupiter:5.11.0\")\n    testRuntimeOnly(\"org.junit.platform:junit-platform-launcher\")\n}\n\ntasks.test {\n    useJUnitPlatform()\n    testLogging {\n        events(\"passed\", \"skipped\", \"failed\")\n    }\n}\n```\n\n### Example pure unit test\n```java\nimport org.junit.jupiter.api.Test;\nimport static org.junit.jupiter.api.Assertions.*;\n\nclass CooldownManagerTest {\n\n    @Test\n    void playerOnCooldown_returnsFalse_afterExpiry() {\n        var manager = new CooldownManager(500L); \u002F\u002F 500ms cooldown\n        manager.startCooldown(\"steve\");\n        assertTrue(manager.isOnCooldown(\"steve\"));\n        \u002F\u002F fast-forward time by sleeping or injecting a Clock\n        assertFalse(manager.isOnCooldown(\"notExisting\"));\n    }\n\n    @Test\n    void cooldown_throwsIllegalArgument_onNegativeDuration() {\n        assertThrows(IllegalArgumentException.class,\n            () -> new CooldownManager(-1L));\n    }\n}\n```\n\n---\n\n## MockBukkit (Paper\u002FBukkit Plugin Tests)\n\n### `build.gradle.kts`\n```kotlin\nrepositories {\n    maven(\"https:\u002F\u002Frepo.papermc.io\u002Frepository\u002Fmaven-public\u002F\")\n    maven(\"https:\u002F\u002Frepo.mockbukkit.org\u002Fartifactory\u002Fmockbukkit\u002F\")\n}\n\ndependencies {\n    compileOnly(\"io.papermc.paper:paper-api:26.2.build.+\")\n    testImplementation(\"org.junit.jupiter:junit-jupiter:5.11.0\")\n    testImplementation(\"com.github.seeseemelk:MockBukkit-v1.21:3.127.0\")\n    testRuntimeOnly(\"org.junit.platform:junit-platform-launcher\")\n}\n\ntasks.test {\n    useJUnitPlatform()\n}\n```\n\n### Setup \u002F teardown pattern\n```java\nimport be.seeseemelk.mockbukkit.MockBukkit;\nimport be.seeseemelk.mockbukkit.ServerMock;\nimport be.seeseemelk.mockbukkit.entity.PlayerMock;\nimport org.junit.jupiter.api.*;\n\nclass MyPluginTest {\n\n    private static ServerMock server;\n    private static MyPlugin plugin;\n\n    @BeforeAll\n    static void setUp() {\n        \u002F\u002F Start mock Bukkit server and load your plugin\n        server = MockBukkit.mock();\n        plugin = MockBukkit.load(MyPlugin.class);\n    }\n\n    @AfterAll\n    static void tearDown() {\n        MockBukkit.unmock();\n    }\n}\n```\n\n### Testing events\n```java\n@Test\nvoid playerJoin_getsWelcomeMessage() {\n    PlayerMock player = server.addPlayer(\"Steve\");\n    player.simulateJoin(); \u002F\u002F fires PlayerJoinEvent\n\n    \u002F\u002F Assert the player received the expected message component\n    player.assertSaid(\"Welcome, Steve!\");\n    \u002F\u002F Or for Adventure components:\n    assertTrue(player.nextMessage().contains(\"Welcome\"));\n}\n\n@Test\nvoid onBlockBreak_cancelledForNonOp() {\n    PlayerMock player = server.addPlayer();\n    player.setOp(false);\n\n    Block block = player.getWorld().getBlockAt(0, 64, 0);\n    block.setType(Material.STONE);\n    BlockBreakEvent event = new BlockBreakEvent(block, player);\n    server.getPluginManager().callEvent(event);\n\n    assertTrue(event.isCancelled(), \"Non-op should not be able to break blocks\");\n}\n```\n\n### Testing commands\n```java\n@Test\nvoid mypluginInfo_returnsVersion() {\n    PlayerMock player = server.addPlayer(\"Admin\");\n    player.setOp(true);\n\n    boolean result = server.dispatchCommand(player, \"myplugin info\");\n\n    assertTrue(result);\n    player.assertSaid(\"Version: \" + plugin.getDescription().getVersion());\n}\n\n@Test\nvoid mypluginReload_requiresOp() {\n    PlayerMock player = server.addPlayer(\"NonOp\");\n    player.setOp(false);\n\n    server.dispatchCommand(player, \"myplugin reload\");\n\n    player.assertSaid(\"No permission.\");\n}\n```\n\n### Testing inventory \u002F items\n```java\n@Test\nvoid giveKitCommand_givesPlayerItems() {\n    PlayerMock player = server.addPlayer();\n    \n    server.dispatchCommand(player, \"kit starter\");\n    \n    \u002F\u002F Check inventory\n    assertTrue(player.getInventory().contains(Material.STONE_SWORD));\n    assertTrue(player.getInventory().contains(Material.BREAD, 16));\n}\n```\n\n### Testing scheduler tasks\n```java\n@Test\nvoid repeatingTask_firesAfterDelay() {\n    PlayerMock player = server.addPlayer();\n    \n    \u002F\u002F Execute 40 ticks worth of scheduled tasks\n    server.getScheduler().performTicks(40L);\n    \n    \u002F\u002F Assert expected side effect happened\n    assertEquals(2, plugin.getTaskCount());\n}\n```\n\n### Testing Folia-safe scheduler abstractions\n\nMockBukkit does not emulate Folia's region-threaded runtime. The safe pattern is to\nwrap scheduling behind your own interface and unit test the abstraction boundary.\n\n```java\ninterface SchedulerFacade {\n    void runPlayerTask(Player player, Runnable task);\n    void runAsync(Runnable task);\n}\n\n@Test\nvoid playerTask_delegatesThroughFacade() {\n    List\u003CString> calls = new ArrayList\u003C>();\n    SchedulerFacade facade = new SchedulerFacade() {\n        @Override\n        public void runPlayerTask(Player player, Runnable task) {\n            calls.add(\"player\");\n            task.run();\n        }\n\n        @Override\n        public void runAsync(Runnable task) {\n            calls.add(\"async\");\n            task.run();\n        }\n    };\n\n    facade.runPlayerTask(server.addPlayer(), () -> calls.add(\"ran\"));\n    assertEquals(List.of(\"player\", \"ran\"), calls);\n}\n```\n\n### Testing PDC\n```java\n@Test\nvoid pdcKillCount_incrementsOnKill() {\n    PlayerMock player = server.addPlayer();\n    NamespacedKey key = new NamespacedKey(plugin, \"kills\");\n    \n    \u002F\u002F Simulate kill event\n    EntityDeathEvent deathEvent = new EntityDeathEvent(\n        server.addMockEntity(EntityType.ZOMBIE), new ArrayList\u003C>(), 0\n    );\n    deathEvent.getEntity().setKiller(player);\n    server.getPluginManager().callEvent(deathEvent);\n    \n    int kills = player.getPersistentDataContainer()\n        .getOrDefault(key, PersistentDataType.INTEGER, 0);\n    assertEquals(1, kills);\n}\n```\n\n### Testing item or chunk PDC writes\n```java\n@Test\nvoid itemPdc_roundTripsCustomId() {\n    NamespacedKey key = new NamespacedKey(plugin, \"custom_id\");\n    ItemStack item = new ItemStack(Material.STICK);\n\n    item.editMeta(meta -> meta.getPersistentDataContainer().set(\n        key, PersistentDataType.STRING, \"wand\"\n    ));\n\n    String value = item.getItemMeta().getPersistentDataContainer()\n        .get(key, PersistentDataType.STRING);\n    assertEquals(\"wand\", value);\n}\n```\n\n---\n\n## NeoForge GameTests\n\nGameTests run inside a Minecraft world. They place a **structure** (the test environment),\nthen run assertions using `GameTestHelper`.\n\n### Registration\n```java\n\u002F\u002F In your mod main class:\n@Mod(MyMod.MOD_ID)\npublic class MyMod {\n    public MyMod(IEventBus modEventBus) {\n        modEventBus.register(MyGameTests.class);\n    }\n}\n```\n\n### Test class\n```java\nimport net.minecraft.gametest.framework.*;\nimport net.neoforged.neoforge.gametest.GameTestHolder;\nimport net.neoforged.neoforge.gametest.PrefixGameTestTemplate;\n\n@GameTestHolder(MyMod.MOD_ID)                \u002F\u002F registers test namespace\n@PrefixGameTestTemplate(false)               \u002F\u002F don't prefix template names\npublic class MyGameTests {\n\n    \u002F\u002F Default template: 3x3x3 air structure called \"mymod:empty\"\n    @GameTest(template = \"mymod:empty\")\n    public static void testBlockInteraction(GameTestHelper helper) {\n        \u002F\u002F Place a block\n        helper.setBlock(1, 1, 1, net.minecraft.world.level.block.Blocks.FURNACE);\n        \n        \u002F\u002F Run after 1 tick\n        helper.runAfterDelay(1, () -> {\n            \u002F\u002F Assert block state\n            helper.assertBlock(new net.minecraft.core.BlockPos(1, 1, 1),\n                b -> b.is(net.minecraft.world.level.block.Blocks.FURNACE),\n                \"Expected furnace\");\n            \n            helper.succeed();\n        });\n    }\n\n    @GameTest(template = \"mymod:empty\", timeoutTicks = 200)\n    public static void testEntitySpawn(GameTestHelper helper) {\n        \u002F\u002F Spawn entity\n        var entity = helper.spawnWithNoFreeWill(\n            net.minecraft.world.entity.EntityType.ZOMBIE, new net.minecraft.core.BlockPos(2, 2, 2)\n        );\n        \n        helper.runAfterDelay(5, () -> {\n            helper.assertEntityPresent(\n                net.minecraft.world.entity.EntityType.ZOMBIE,\n                new net.minecraft.core.BlockPos(2, 2, 2), 1.0\n            );\n            helper.succeed();\n        });\n    }\n}\n```\n\n### Structure templates (`.nbt` files)\nPlace empty structure files at:  \n`src\u002Fmain\u002Fresources\u002Fdata\u002Fmymod\u002Fstructures\u002Fempty.nbt`\n\nGenerate them in-game using `\u002Ftest create mymod:empty 3 3 3` (NeoForge test command).\nCommit the `.nbt` files to version control.\n\n### GameTest setup checklist\n\n1. Verify `.nbt` structure files exist at `src\u002Fmain\u002Fresources\u002Fdata\u002F\u003Cmodid>\u002Fstructures\u002F`\n2. Run `.\u002Fgradlew runGameTestServer` — if tests fail with \"Missing template\", the `.nbt` file path or name is wrong\n3. Check Gradle output for `PASSED`\u002F`FAILED` per test\n4. If a test times out, increase `timeoutTicks` in the `@GameTest` annotation or add intermediate assertions with `runAfterDelay`\n\n### Running GameTests\n```bash\n.\u002Fgradlew runGameTestServer\n\n# In-game (dev environment):\n# \u002Ftest runall\n# \u002Ftest run mymod:test_block_interaction\n```\n\n---\n\n## Fabric GameTests\n\n```java\nimport net.fabricmc.fabric.api.gametest.v1.FabricGameTest;\nimport net.minecraft.core.BlockPos;\nimport net.minecraft.gametest.framework.GameTest;\nimport net.minecraft.gametest.framework.GameTestHelper;\nimport net.minecraft.world.level.block.Blocks;\n\npublic class MyFabricGameTests implements FabricGameTest {\n\n    @GameTest(template = EMPTY_STRUCTURE)\n    public void testCustomBlock(GameTestHelper helper) {\n        helper.setBlock(1, 1, 1, Blocks.GOLD_BLOCK.defaultBlockState());\n        \n        helper.runAfterDelay(2, () -> {\n            helper.assertBlock(\n                new BlockPos(1, 1, 1),\n                b -> b.is(Blocks.GOLD_BLOCK),\n                \"Gold block should be placed\"\n            );\n            helper.succeed();\n        });\n    }\n}\n```\n\n### Register in `fabric.mod.json`\n```json\n{\n  \"entrypoints\": {\n    \"fabric-gametest\": [\n      \"com.example.mymod.fabric.MyFabricGameTests\"\n    ]\n  }\n}\n```\n\n---\n\n## `GameTestHelper` Assertions Reference\n\n```java\n\u002F\u002F Block assertions\nhelper.assertBlock(pos, predicate, \"message\");\nhelper.assertBlockState(pos, state -> state.is(Blocks.STONE), \"Expected stone\");\nhelper.assertBlockPresent(Blocks.GOLD_BLOCK, pos);\nhelper.assertBlockNotPresent(Blocks.TNT, pos);\n\n\u002F\u002F Entity assertions\nhelper.assertEntityPresent(EntityType.ZOMBIE, pos, radius);\nhelper.assertEntityNotPresent(EntityType.ZOMBIE);\nhelper.assertEntityCount(EntityType.ZOMBIE, expectedCount);\nhelper.assertEntityProperty(entity, entity -> entity.getHealth() > 0, \"alive\");\n\n\u002F\u002F Item assertions\nhelper.assertContainerContains(pos, Items.DIAMOND);\nhelper.assertContainerEmpty(pos);\n\n\u002F\u002F Control flow\nhelper.succeed();        \u002F\u002F mark test as passed — REQUIRED at end\nhelper.fail(\"reason\");   \u002F\u002F mark test as failed\nhelper.runAfterDelay(ticks, runnable); \u002F\u002F schedule assertion\nhelper.onEachTick(runnable);          \u002F\u002F run every tick (use with care)\nhelper.succeedWhen(() -> { \u002F* assertions *\u002F }); \u002F\u002F poll until assertions pass or timeout\nhelper.succeedOnTickWhen(tick, () -> { \u002F* assertions *\u002F });\n```\n\n---\n\n## CI: Running Tests in GitHub Actions\n\nSplit CI into fast unit\u002Fmock coverage and slower runtime-facing jobs. MockBukkit is great\nfor command\u002Fevent logic, but it does not prove Folia thread safety or real server bootstrap.\n\n```yaml\n# .github\u002Fworkflows\u002Ftest.yml\nname: Tests\n\non: [push, pull_request]\n\njobs:\n    unit-tests:\n        runs-on: ubuntu-latest\n        steps:\n            - uses: actions\u002Fcheckout@v4\n            - { uses: actions\u002Fsetup-java@v4, with: { java-version: '21', distribution: 'temurin' } }\n            - uses: gradle\u002Factions\u002Fsetup-gradle@v3\n            - { name: Run unit tests, run: .\u002Fgradlew test }\n\n    game-tests:\n        runs-on: ubuntu-latest\n        steps:\n            - uses: actions\u002Fcheckout@v4\n            - { uses: actions\u002Fsetup-java@v4, with: { java-version: '21', distribution: 'temurin' } }\n            - uses: gradle\u002Factions\u002Fsetup-gradle@v3\n            - { name: Run GameTests (headless), run: .\u002Fgradlew runGameTestServer, env: { CI: true } }\n\n    layout-checks:\n        runs-on: ubuntu-latest\n        steps:\n            - uses: actions\u002Fcheckout@v4\n            - { name: Validate test layout, run: .\u002Fscripts\u002Fvalidate-test-layout.sh --root . }\n```\n\n---\n\n## References\n\n- MockBukkit GitHub: https:\u002F\u002Fgithub.com\u002FMockBukkit\u002FMockBukkit\n- MockBukkit docs: https:\u002F\u002Fmockbukkit.readthedocs.io\u002F\n- NeoForge GameTest docs: https:\u002F\u002Fdocs.neoforged.net\u002Fdocs\u002Fmisc\u002Fgametest\u002F\n- Fabric GameTest API: https:\u002F\u002Fwiki.fabricmc.net\u002Ftutorial:gametests\n- JUnit 5 user guide: https:\u002F\u002Fjunit.org\u002Fjunit5\u002Fdocs\u002Fcurrent\u002Fuser-guide\u002F\n",{"name":5,"description":7},"main","6fdc6b3043932f6cec4d0a2d51630b19d220dc0d","plugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-testing",1,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle","https:\u002F\u002Fgithub.com\u002FAIKUSAN","Creating virtual worlds, one line of code at a time.","2026-10-03 22:21:47",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-testing",{"tool":38,"command":39},"bunx","bunx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-testing",{"tool":41,"command":42},"pnpm","pnpm dlx skills add AIKUSAN\u002Fminecraft-agent-skills-bundle --skill minecraft-testing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-testing\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Ftest-layouts.md","REFERENCE","参考文档",1897,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-testing\u002Freferences\u002Ftest-layouts.md",{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"scripts\u002Fvalidate-test-layout.sh","SCRIPT","脚本",3514,"https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Fplugins\u002Fminecraft-codex-skills\u002Fskills\u002Fminecraft-testing\u002Fscripts\u002Fvalidate-test-layout.sh",[59,66,72,78,84,90],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M74FXYYEC9NE1YFJC891WFT2","minecraft-ci-release","Fixture with valid workflow YAML but a warning-only secrets section.","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fwarn-only\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M74FXXD5F0J0VA58R53Z8CA3","valid","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fvalid\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M74FXVT401WRMHEMCPJKA89X","non-workflow-yaml","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fnon-workflow-yaml\u002FSKILL.md",[],[],{"skillNo":79,"name":61,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M74FXTBGQGEPGMX81DFY7FY9","Fixture with valid multiline flow collections in workflow YAML.","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Fmultiline-flow\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M74FXSAW6GDZ3J3S9FBGC1D6","invalid","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Finvalid\u002FSKILL.md",[],[],{"skillNo":91,"name":61,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M74FXQRKYD2DDQDN0HR1TE10","Fixture with malformed workflow YAML.","https:\u002F\u002Fgithub.com\u002FAIKUSAN\u002Fminecraft-agent-skills-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fvalidators\u002Fci-release\u002Finvalid-yaml\u002FSKILL.md",[],[]]