View source for Invite System

== How do invites work? ==

In customizer, you can add a creation (called UI in pre-v3.0) of the "invite" type. This is like the base for invites

== How to create an invite ==

1. Go to `Config UI`
2. Go to `Customizer`
3. Click `Add`
4. Scroll down to "Invite"
5. Set the unique ID (remember, no spaces in invite unique ids! and they wont be displayed to the player)
6. Fill in the expiration time (if needed), remember: 20 ticks = 1 second, 1200 ticks = 1 minute

== Setting up the invites ==

When editing invites you can edit the actions of 4 things:
- Deny actions: ran when invite is denied
- Accept actions: ran when invite is accepted
- Expiration actions: ran when invite expires
- Send actions: ran when invite is sent

<hr />

<blockquote>
# You do need to be familiar with the formatting system, and something else to note is the formatting system has 2 copies of the player-related variables in some places. Like, <code><name></code> has a <code><name2></code> counterpart. This is for multiple players.
# Player 1 = The player who received the invite
# Player 2 = The player who sent the invite
</blockquote>

== Creating the invite UI ==

Invites dont do anything on their own, so heres how you set up a UI

=== Create the UI ===

This should just be a normal creating UI process, so you do have to be familiar with creating UIs.

=== Create a send button ===

The action should be <code>/scriptevent leafgui:invite UNIQUE_ID</code>

<blockquote>
<h3>TIP:<h3>
You can put a command in quotes after the leafgui:invite scriptevent, like:

/scriptevent leafgui:invite UNIQUE_ID "/scriptevent leaf:open your-invite-ui"

This will allow the invite UI to reopen your UI once the player is done interacting with it.
</blockquote>

=== Create a incoming invites button ===

Create a button, and choose whatever icon (if wanted). The display should be something like `Invite from <name2>` (just an example, just gives you an idea)

Use whatever for the action, i recommend just putting a <code>/</code> since it will go unused after setting up the meta

Now, the special part is after you create the button:
> Edit the button
> Edit meta to "#INVITES UNIQUE_ID" (<code>#INVITES</code> is case sensitive, make sure its all uppercase)

=== Create a outgoing invites button ===

Repeat the steps from the incoming invites button (example text for this one would be: <code>Invite to <name></code>)

This time, the meta should be "#INVITES UNIQUE_ID out" (<code>out</code> should be all lowercase)

== Test your UI ==

Open your UI and make sure it works. You might need another player (e.g. friend, alt account) online to help test it with you.