https://github.com/scraft-official/skScraft
skScraft - Bungee Syntaxes for Skript
https://github.com/scraft-official/skScraft
skript-addon
Last synced: 4 months ago
JSON representation
skScraft - Bungee Syntaxes for Skript
- Host: GitHub
- URL: https://github.com/scraft-official/skScraft
- Owner: scraft-official
- Created: 2021-01-06T12:22:26.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-06-11T23:03:37.000Z (about 4 years ago)
- Last Synced: 2024-12-10T19:54:42.612Z (7 months ago)
- Topics: skript-addon
- Language: Java
- Homepage:
- Size: 146 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-skript - skScraft - official) - Yet another BungeeCord addon for Skript. (Addons / Proxy Addons)
- awesome-skript - skScraft - official) - Yet another BungeeCord addon for Skript. (Addons / Proxy Addons)
README
# skScraft - BungeeCord syntaxes for Skript
skScraft - Easy to use BungeeCord syntaxes for Skript. With config to edit default messages (ex. Default message when stopping proxy server).
**Versions Supported**: 1.9, 1.10, 1.11, 1.12, 1.13, **(1.14, 1.15, 1.16 follow INSTALLATION [MC 1.14-1.16])**
# INSTALLATION
To use skScraft you need to install some dependencies. **Skript** of course is the main one, but to make skScraft connect and communicate with **BungeeCord**, you need to upload **BungeeBridge** plugin on your **Spigot server**, and **BungeeCord Proxy**.
## INSTALLATION [MC 1.9-1.13]:
- Don't forget to download Skript and BungeeBridge to make it work!
- Skript - https://github.com/SkriptLang/Skript/releases
- Download **BungeeBridge[1.9-1.13].zip**, added to [latest release of skScraft](github.com/scraft-official/skScraft/releases/latest "Click here to download, special release!").
- Unzip BungeeBridge[1.9-1.13].zip
- Upload BungeeBridge_Client to all of your spigot servers, and BungeeBridge_Server to BungeeCord proxy!
- Download **[latest](https://github.com/scraft-official/skScraft/releases/tag/1.0 "Click here to download, latest release!")** release of **skScraft**.
- Upload skScraft ONLY to your spigot server!
- Launch **BungeeCord** proxy first, then **Spigot** server, and *change config* file of *BungeeBridge* if you need. (If you have different IP adresses of BungeeCord proxy and Spigot server in example.)
- If you want to see some **additional information** (*about why you have null, when you use one of syntaxes*) go to **skScraft directory**, and set **DEBUG MODE** to true in **config.yml**. Then go back to the server and type command **/skScraft reload** in console or as a player.
## INSTALLATION [MC 1.14-1.16]:
- Don't forget to download Skript and BungeeBridge to make it work!
- Skript - https://github.com/SkriptLang/Skript/releases
- Download **BungeeBridge[1.14-1.16].zip**, added to [latest release of skScraft](github.com/scraft-official/skScraft/releases/latest "Click here to download, special release!").
- Unzip BungeeBridge[1.14-1.16].zip.
- Upload BungeeBridge_Client to all of your spigot servers, and BungeeBridge_Server to BungeeCord proxy!
- Download **[latest](https://github.com/scraft-official/skScraft/releases/tag/1.0 "Click here to download, latest release!")** release of **skScraft**.
- Upload skScraft ONLY to your spigot server!
- Launch **BungeeCord** proxy first, then **Spigot** server, and *change config* file of *BungeeBridge* if you need. (If you have different IP adresses of BungeeCord proxy and Spigot server in example.)
- If you want to see some **additional information** (*about why you have null, when you use one of syntaxes*) go to **skScraft directory**, and set **DEBUG MODE** to true in **config.yml**. Then go back to the server and type command **/skScraft reload** in console or as a player.
------------
***Very important!** When you will use **skScraft** syntaxes, use **parasing player as text** (ex. "%player%", "%arg-1%"). The main reason of that, is parasing online player by skript, can not work correctly, if player is not connected to the same server where the syntax is used. So **always** parse **player** **as** **text**, to make it **working** without problems!
***NOT CORRECT*** -> ( *if player is connected to bungeecord network* )
***CORRECT*** -> ( *if "%player%" is connected to bungeecord network* )
------------
# SYNTAXES
#### CONDITIONS
```java
[player] %string% is connected to [bungeecord] network
server %string% is online
server %string% is offline
```
#### EFFECTS
```java
broadcast bungee[cord] message %string%
send bungee[cord] message %string% to [player] %string%
(send|connect) [player] %string% to bungee[cord] server %string%
execute command %string% on [bungee[cord]] network as [player] %string%
execute command %string% on [bungee[cord]] proxy
kick all players from [bungee[cord]] network [with message %string%]
stop [bungee[cord]] proxy [with message %string%]
kick %string% from bungeecord [network] due to %string%
send bungee[cord] actionbar %string% to [player] %string%
send bungee[cord] title %string% with subtitle %string% for %integer% [tick[s]] with %integer% [tick[s]] fade in and %integer% [tick[s]] fade out to [player] %string%
/!\ Don't use default timespan from skript. Title effect allow only for integers (1 = 1 tick | 20 = 1 second | 100 = 5 seconds | 1200 = 1 minute).
```
#### EXPRESSIONS
```java
[bungee[cord]] server of [player] %string%
number of players on [bungee[cord]] network
number of players on [bungee[cord]] server %string%
[bungee[cord]] network uuid of [player] %string%
[number of] [max] slots of [bungee[cord]] server %string%
[bungee[cord]] network ip of [player] %string%%
name of [this] server on [bungee[cord]] network
[perfectly] centered text %string%
[perfectly] centered limited text %string% with max [limit] of %integer% [spaces]
```
* [] - You don't need to use text inside of this characters (ex. [bungee[cord]] -> use bungeecord or bungee)
* () - You can choose wich text you want to use (ex. (send|connect) -> use send or connect)
[](http://skripthub.net/docs/?addon=skScraft)
------------
#### DO YOU HAVE ANY SUGESTIONS FOR OTHER SYNTAX?
If you want me to add more **bungeecord syntaxes** to this addon, join to my **discord server**, and add your proposition on channel **suggestions**.
#### DO YOU HAVE ANY ISSUES?
If you found any bugs or issue when using my addon, fell free to join to skScraft discord server. I will try to do my best to help you, and find the solution. ;).
**skScraft Discord link ->** https://discord.gg/MBYEeukXuT
**My Discord ID ->** 🚀 Scraft Official 🚀#9999
------------
#### EXAMPLE OF SYNTAXES:
```java
command /text:
trigger:
set {_text1} to perfectly centered text "Hi, this is a very good centered"
set {_text2} to perfectly centered text "&lMESSAGE :D"
send "%{_text1}%"
send "%{_text2}%"
command /text2:
trigger:
set {_text1} to perfectly centered limited text "scraft" with max limit of 22 spaces
set {_text2} to perfectly centered limited text "----" with max limit of 22 spaces
send "%{_text1}%"
send "%{_text2}%"
```
```java
command /test:
trigger:
send ""
send "&eskScraft &e» &6TO SEE THE REAL MAGIC IN CONSOLE:"
send "&eskScraft &e» &6SET &dDEBUG MODE &6TO &dTRUE &6IN CONFIG"
send ""
loop 5 times:
send "&eskScraft &e» &cStarting in &d%6-loop-number%&6."
wait 20 ticks
#CONDITIONS
#Check if player is connected to network, VERY IMPORTAN PUT PLAYER AS TEXT NOT AS PLAYER!!! {"%player%", "%arg-1%", ect...}
if "%player%" is connected to bungeecord network:
send "&eskScraft &e» &6You are connected!"
else:
send "&eskScraft &e» &6Hmmmm, there is an issue! Is bungeecord connected?"
wait 60 ticks
if "scraft_official" is connected to bungeecord network:
send "&eskScraft &e» &6Oh! Scraft is on your server?!"
else:
send "&eskScraft &e» &6Scraft_official is offline!"
send "&eskScraft &e» &6You can send him pm to not be alone :P"
wait 60 ticks
#Check if server is ONline, VERY IMPORTAN PUT PLAYER AS TEXT NOT AS PLAYER!!! {"%player%", "%arg-1%", ect...}
if server "servername2" is online:
send "&eskScraft &e» &6Servername2 is online!"
else:
send "&eskScraft &e» &6Servername2 is offline!"
wait 60 ticks
#Check if server is OFFline, VERY IMPORTAN PUT PLAYER AS TEXT NOT AS PLAYER!!! {"%player%", "%arg-1%", ect...}
set {_server} to bungeecord server of "%player%"
if server {_server} is offline:
send "&eskScraft &e» &6Your server %{_server}% is offline! Wait, what????? How did you run the command???"
else:
send "&eskScraft &e» &6Nope! Your server %{_server}%&6 is online!"
wait 60 ticks
#EXPRESSIONS
#Get the server of given player, VERY IMPORTAN PUT PLAYER AS TEXT NOT AS PLAYER!!! {"%player%", "%arg-1%", ect...}
set {_server} to bungeecord server of "%player%"
send "&eskScraft &e» &6You are connected to %{_server}%&6!"
wait 60 ticks
#Get number of players on the given server.
set {_online} to number of players on bungeecord server "servername2"
send "&eskScraft &e» &6The server should be offline, and give ."
send "&eskScraft &e» &6Result %{_online}%."
wait 60 ticks
#EXAMPLE OF GETTING NUMBER OF PLAYERS ON SERVER OF GIVEN PLAYER, REMEBER TO PUT PLAYER AS TEXT!!!
set {_server} to bungeecord server of "%player%"
set {_online} to number of players on bungeecord server {_server}
send "&eskScraft &e» &6Players connected to your server: %{_online}%"
wait 60 ticks
#Get number of players connected to bungeecord network.
set {_online} to number of players on bungeecord network
send "&eskScraft &e» &6The number of connected players to network is: %{_online}%"
wait 60 ticks
#EFFECTS
#Broadcast given message to all bungee cord servers.
broadcast bungeecord message "&eskScraft &e» &6skScraft is amazing! It can broadcast messages!"
wait 60 ticks
#Send message to certain player, VERY IMPORTAN PUT PLAYER AS TEXT NOT AS PLAYER!!! {"%player%", "%arg-1%", ect...}
send bungee message "&eskScraft &e» &6It can send messages to given player!" to "%player%"
wait 60 ticks
#Connect player to given server, VERY IMPORTAN PUT PLAYER AS TEXT NOT AS PLAYER!!! {"%player%", "%arg-1%", ect...}
connect player "%player%" to bungeecord server "servername2"
send "&eskScraft &e» &6You can connect player to another server of your network, for this example it will give no results."
#ADVANCED EXAMPLES
#set {_online} to number of players on bungeecord server (bungeecord server of "%player%")
#if server (bungeecord server of "%player%") is online:
wait 120 ticks
send ""
send "&eskScraft &e» &6THIS WAS LAST EXAMPLE"
send "&eskScraft &e» &6IF YOU HAVE A SUGGESTION FOR NEW FEATURE"
send "&eskScraft &e» &6JOIN TO skScraft DISCORD SERVER:"
send "&eskScraft &e» &dhttps://discord.gg/MBYEeukXuT"
```