Getting Started

Welcome to the Oasis Admin Editor — a visual, node-based editor designed to create automation flows for your Minecraft server without writing code.

What is the Admin Editor?

The Admin Editor lets you define server behaviors using a graphical flow editor. Instead of writing Java code, you connect nodes on a canvas to describe what should happen and when.

A flow is a complete automation, such as:

• A /spawn command that teleports players to spawn
• A join message that greets players with a title
• A kill reward system that gives items and XP on kills
• A voting system with cooldowns and permission checks

Core Concepts

Flows

A flow is a saved automation that consists of nodes and edges (connections). Every flow starts with at least one trigger node, which is the entry point that determines when the flow runs.

There are three types of triggers:

Type	Description
Command	Activated when a player types a command (e.g., /spawn)
Event	Activated when a game event occurs (e.g., player joins, block broken)
Function	A reusable function that can be called

Nodes

Nodes are the building blocks of your flow. Each node represents a single instruction or decision point. There are five categories:

Category	Color	Purpose
Triggers	🟢 Green	Entry points — how a flow starts
Actions	🔵 Blue	Do something — send messages, teleport, give items
Conditions	🟣 Purple	Check something — branch the flow based on a test
Flow Control	🟠 Orange	Control execution — loops, delays, branching
Other	⚪ Gray	Utilities — comments, groups

Edges

Edges are the lines connecting nodes. They define the order of execution. When a trigger node fires, execution follows the edges from node to node.

Some nodes have multiple outputs (e.g., conditions have "Yes" and "No"), letting you branch the flow based on different outcomes.

Placeholders

Many node fields support placeholders — dynamic values that are replaced at runtime. Placeholders use the %name% format:

• %player% — the triggering player's username
• %health% — the player's current health
• %world% — the current world name

See the full Placeholders Reference for all available placeholders.

Quick Start

1. Open the Dashboard — Log in and you'll see your flow dashboard.
2. Join a Flow — Click on an existing flow to view or edit it, or click "New Flow" to create a new one.
3. Add Nodes — Open the node palette (left sidebar) and drag nodes onto the canvas.
4. Connect Nodes — Drag from an output handle to an input handle to create an edge.
5. Configure Nodes — Click a node and use the inspector (right sidebar) to set its properties.
6. Deploy — Click "Deploy" in the header to push your flow to the Minecraft server.