Skip to content
This repository was archived by the owner on Mar 5, 2025. It is now read-only.

Commit 2ac74eb

Browse files
committed
Add readme and documentation
1 parent 944a5b3 commit 2ac74eb

File tree

6 files changed

+84
-0
lines changed

6 files changed

+84
-0
lines changed

README.md

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
![MineplexSK Banner](https://i.imgur.com/zO4o6Rb.png)
2+
3+
An unofficially supported Skript addon that allows you to use Skript within the Mineplex ecosystem, and interact with the special provided [Mineplex SDK](https://studio.mineplex.com/docs/sdk).
4+
5+
> [!IMPORTANT]
6+
> This isn't an official addon provided by Mineplex itself. This is a community developed and supported addon. We rely on contributions for this!
7+
8+
## Addon Documentation
9+
[Expressions](/docs/expressions.md)[Conditions](/docs/conditions.md)[Effects](/docs/effects.md)[Events](/docs/events.md)[Functions](/docs/functions.md)
10+
11+
12+
## Purpose
13+
This exists to make it easier for people without Java knowledge to setup and use the Mineplex ecosystem, with the goal being to make it far easier for people to manage and create their projects quickly.
14+
Our goal with this addon is to have this addon have full feature parity with the actual Mineplex Java SDK.
15+
16+
### Pre-requisites
17+
- You must have [Skript plugin](https://github.com/SkriptLang/Skript/releases) downloaded already, this addon requires it!
18+
- You must have a [Mineplex Studio project](https://studio.mineplex.com/docs/getting-started) created and ready to use
19+
20+
## How to install
21+
- Add your **Skript** plugin into a directory within your Mineplex project named `external-plugins`
22+
- Download the [latest version](https://github.com/BillyDotWS/MineplexSK/releases) of the addon from the Releases.
23+
- Add this addon jar into the same `external-plugins` directory
24+
25+
## How to use
26+
This Skript addon allows you to use the Skript 'way of coding' with the Mineplex SDK. In order to do this, it adds some custom language to Skript to allow for usage.
27+
28+
### Using skript within Mineplex projects
29+
*Note: requires you to have followed the Installation steps first*
30+
31+
In order to use Skript scripts within a project, drop your skript's into a folder (within your project). Within `external-plugins`, create a directory called `Skript`, within this directory, create another called `scripts`.
32+
33+
Then create your Skript file (the same way as everywhere else): `scriptName.sk`
34+
35+
After that, use Skript the same way as normal, dropping extra scripts into the folder(s) and building your project!
36+
37+
## Contributing
38+
> [!CAUTION]
39+
> This repository enforces a copyleft licence, meaning you cannot create a private version of this repository. Please contribute any improvements you make back to the base repository to assist in making it easier to use Skript on Mineplex for everyone!
40+
41+
We welcome contributions to improve this project! Please follow these guidelines to ensure a smooth contribution process:
42+
43+
### How to Contribute
44+
45+
1. **Fork the Repository**
46+
Create a fork of this repository to your GitHub account.
47+
2. **Clone Your Fork**
48+
Clone your fork to your local machine:
49+
```bash
50+
git clone https://github.com/your-username/repository-name.git
51+
```
52+
3. **Create a Branch**
53+
Use a descriptive name for your branch:
54+
```bash
55+
git checkout -b feature/your-feature-name
56+
```
57+
4. **Make Your Changes**
58+
Make Your Changes
59+
Ensure your changes follow the coding standards and do not introduce any bugs.
60+
5. **Run Tests**
61+
Run all tests to confirm that your changes do not break existing functionality:
62+
```bash
63+
mvn test
64+
```
65+
6. **Commit Your Changes**
66+
Write clear and concise commit messages:
67+
```bash
68+
git add .
69+
git commit -m "feature: description of your changes"
70+
```
71+
7. **Push Your Branch**
72+
Push your branch to your forked repository:
73+
```bash
74+
git push origin feature/your-feature-name
75+
```
76+
8. **Open a Pull Request**
77+
```bash
78+
git push origin feature/your-feature-name
79+
```

docs/conditions.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
## Conditions

docs/effects.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
## Effects

docs/events.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
## Events

docs/expressions.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
## Expressions

docs/functions.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
## Functions

0 commit comments

Comments
 (0)