[HR][/HR]

>> How to Create a Gate


Step 1. Get a Compass (default creation tool) from your inventory.

Step 2. Rename it in an Anvil — the name you give it will be the gate's Network ID.
Example: rename it "home" to create a gate network called "home".

Step 3. Build a frame using any blocks. By default the frame must contain at least 2 Emerald Blocks.

Step 4. Right-click any block of the frame with the renamed Compass.

Step 5. A portal type selector GUI will open — choose your portal type.

Step 6. Build a second gate with the same name and same owner to link them together.
Both gates will teleport players between each other automatically.


[HR][/HR]

>> Configuration (config.yml)


SoundTeleportEnabled (true/false)
Plays a sound when a player teleports through a gate.

PigmanPortalSpawnEnabled (true/false)
Allows or prevents Zombified Piglins from spawning near gates.

RemovingCreateToolName (true/false)
After creating a gate, removes the name from the tool (returns it unnamed).

RemovingCreateToolItem (true/false)
After creating a gate, removes the tool entirely from the player's inventory.

ItemRequiredToCreatePortal (Material name)
The item the player must hold to create a gate. Default: COMPASS.

MaxPortalSize (number)
Maximum number of blocks a portal interior can have. Default: 200.

DisabledWorlds (list)
List of worlds where gate creation is disabled. Example:



BlockRequiredToCreatePortal
The material and amount required in the frame to create a gate. Example:



GUISettings
Configures the portal type selector inventory.
InventoryType: HOPPER, CHEST or DISPENSER
Title: Supports color codes and hex colors (&#RRGGBB)
FillEmptySlots: Fill empty slots with gray glass panes

PortalsTypeItem
Define custom portal types. Each entry supports:
Material: Icon shown in GUI
MaterialContent: Block that fills the portal
Slot: Position in the GUI inventory
Name: Display name (supports color codes)
Lore: Description lines
ParticleEffect.Type: Particle name (optional)
ParticleEffect.Color: RED, GREEN, BLUE, PURPLE... or hex (&#RRGGBB)


[HR][/HR]

>> FAQ


Q: My gate is not creating, what's wrong?
A: Make sure the Compass is renamed in an Anvil, your frame contains the required blocks, and you are not in a disabled world.

Q: Can two different players link their gates?
A: No. Gates are linked by Network ID + owner. Only gates created by the same player with the same name will connect.

Q: What happens if I break the frame?
A: The gate is automatically destroyed and removed from the system.

Q: Can I change the portal type after creating it?
A: Currently no. You need to destroy and recreate the gate to change its type.

Q: Players are getting the "The End?" advancement when using End portals.
A: Make sure ProtocolLib is installed correctly. SimpleGate uses it to send a fake END_GATEWAY packet that prevents this advancement from triggering.

Q: How many gates can one player create?
A: Each player can create a maximum of 2 gates per Network ID (one origin, one destination).

Q: Does SimpleGate support 1.8?
A: Yes, SimpleGate supports Minecraft 1.8 through 1.21.x.


[HR][/HR]