Table of Contents

• Guides
  • Test Writing
  • Integration
  • Common Scenarios
    • Testing Plugin Commands
    • Testing Entity Interactions
    • Testing Inventory
  • Need More?

Guides

In-depth guides for writing effective tests with Pilaf.

Test Writing

• Writing Tests - Test structure, patterns, and best practices

• Actions Reference - Complete list of available actions

• Assertions Guide - All assertion types and usage

Integration

• Testing Environment Setup - Docker configuration for deterministic tests

• GitHub Actions Integration - Set up CI/CD for your plugin

Common Scenarios

Testing Plugin Commands

Use execute_player_command to test your plugin’s commands:

{
  name: 'Test plugin version command',
  action: 'execute_player_command',
  player: 'testplayer',
  command: '/myplugin version'
}

Testing Entity Interactions

Use get_entities with entity_exists assertions:

steps: [
  { action: 'get_entities', player: 'p', store_as: 'e' },
  { action: 'assert', condition: 'entity_exists', expected: 'zombie', actual: '{e}' }
]

Testing Inventory

Use get_player_inventory with has_item assertions:

steps: [
  { action: 'execute_command', command: 'give p diamond' },
  { action: 'get_player_inventory', player: 'p', store_as: 'inv' },
  { action: 'assert', condition: 'has_item', expected: 'diamond', actual: '{inv}' }
]

Need More?

• Check Core Topics for internal details

• See Reference for API documentation

• Report issues at GitHub Issues

---

Table of contents

• Writing Tests
• Actions Reference
• Assertions
• GitHub Actions Integration
• Testing Environment Setup