refactor: update plugin to 0.2.4
* feat: update plugin to 0.2.4 * docs: add kick-start description
This commit is contained in:
parent
bab30b7568
commit
86582c28de
4 changed files with 83 additions and 13 deletions
55
README.md
Normal file
55
README.md
Normal file
|
|
@ -0,0 +1,55 @@
|
|||
# Hytale Plugin Template
|
||||
|
||||
A ready-to-use starting point for creating Hytale server plugins with Java, _or Kotlin_. If you've
|
||||
been using the Asset Editor and want to start writing server-side logic — custom commands, event
|
||||
handling, gameplay systems — this is the simplest place to begin.
|
||||
|
||||
## How to start?
|
||||
|
||||
1. Copy the template by downloading it or using the "Use this template" button.
|
||||
2. [Configure or Install the Java SDK](https://hytalemodding.dev/en/docs/guides/plugin/setting-up-env)
|
||||
to use the latest 25 from JetBrains or similar.
|
||||
3. Open the project in your favorite IDE, we
|
||||
recommend [IntelliJ IDEA](https://www.jetbrains.com/idea/download).
|
||||
4. Optionally, run `./gradlew` if your IDE does not automtically synchronizes.
|
||||
5. Run the devserver with the Run Configuration created, or `./gradlew devServer`.
|
||||
|
||||
> On Windows, use `.\gradlew.bat` instead of `./gradlew`, this script is here to run the
|
||||
> Gradle without you needing to install the tooling itself, only the Java is required.
|
||||
|
||||
With that you will be prompted in the output to authorize your server, and then you can start
|
||||
developing your plugin while the server is live reloading the code changes.
|
||||
|
||||
From here,
|
||||
the [HytaleModding guides](https://hytalemodding.dev/en/docs/guides/plugin/build-and-test) cover
|
||||
more details!
|
||||
|
||||
## Scaffoldit Plugin
|
||||
|
||||
While there are multiple plugins made for Hytale, the template currently uses a zero-boilerplate one
|
||||
where you only need the absolute minimum to start. However, you do have access to everything as
|
||||
normal if you know what you are doing.
|
||||
|
||||
For in-depth configuration, you can visit the [ScaffoldIt Plugin Docs](https://scaffoldit.dev).
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
- **Gradle sync fails in IntelliJ** –
|
||||
_Check that Java 25 is installed and configured under File → Project Structure → SDKs._
|
||||
- **Build fails with missing dependencies** –
|
||||
_Run `./gradlew build --refresh-dependencies`. Make sure you have internet access!_
|
||||
- **Permission denied on `./gradlew`** –
|
||||
_Run `chmod +x gradlew` (macOS/Linux)._
|
||||
- **Hot-reload doesn't work** –
|
||||
_Verify you're using JetBrains Runtime, not a regular JDK._
|
||||
|
||||
## Resources
|
||||
|
||||
- [Hytale Modding Guides](https://hytalemodding.dev)
|
||||
- [Hytale Modding Discord](https://discord.gg/hytalemodding)
|
||||
- [ScaffoldIt Plugin Docs](https://scaffoldit.dev)
|
||||
|
||||
## License
|
||||
|
||||
Add your own after copying the template, though we recommend using MIT, BSD, or Apache to keep
|
||||
the modding community open!
|
||||
|
|
@ -1,15 +1,11 @@
|
|||
plugins {
|
||||
java
|
||||
}
|
||||
|
||||
group = "dev.hytalemodding"
|
||||
version = "0.0.1"
|
||||
|
||||
/**
|
||||
* NOTE: This is entirely optional and basics can be done in `settings.gradle.kts`
|
||||
*/
|
||||
|
||||
repositories {
|
||||
mavenCentral()
|
||||
// Any external repositories besides: MavenLocal, MavenCentral, HytaleMaven, and CurseMaven
|
||||
}
|
||||
|
||||
dependencies {
|
||||
// Any dependency you also want to include
|
||||
// Any external dependency you also want to include
|
||||
}
|
||||
8
gradle.properties
Normal file
8
gradle.properties
Normal file
|
|
@ -0,0 +1,8 @@
|
|||
org.gradle.daemon=true
|
||||
org.gradle.parallel=true
|
||||
# Turn the following on once you finished changing your settings/build:
|
||||
# org.gradle.configuration-cache=true
|
||||
# org.gradle.caching=true
|
||||
|
||||
# Optional Hytale location for the Assets.zip resolution:
|
||||
# hytale.home_path=...
|
||||
|
|
@ -2,13 +2,24 @@ rootProject.name = "dev.hytalemodding"
|
|||
|
||||
plugins {
|
||||
// See documentation on https://scaffoldit.dev
|
||||
id("dev.scaffoldit") version "0.2.2"
|
||||
id("dev.scaffoldit") version "0.2.4"
|
||||
}
|
||||
|
||||
//
|
||||
// Automatically configures the builds, but you can switch scripts if you wish!
|
||||
//
|
||||
// Would you like to do a split project?
|
||||
// Create a folder named "common", then configure details with `common { }`
|
||||
|
||||
hytale {
|
||||
usePatchline("release")
|
||||
useVersion("+")
|
||||
|
||||
repositories {
|
||||
// Any external repositories besides: MavenLocal, MavenCentral, HytaleMaven, and CurseMaven
|
||||
}
|
||||
|
||||
dependencies {
|
||||
// Any external dependency you also want to include
|
||||
}
|
||||
|
||||
manifest {
|
||||
Group = "HytaleModding"
|
||||
Name = "ExamplePlugin"
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue