1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
# How to Contribute
This is a technical guide that helps Kotin and Java developers to code with SkyHanni.
# Setup the developement enviroment
When making changed to the code, it is recommended to use an IDE for live debugging and testing.
This tutorial explains how to set up the developement enviroment for SkyHanni.
We use [IntelliJ](https://www.jetbrains.com/idea/) as an example.
## Download IntelliJ
- Download IntelliJ from [JetBrains Website](https://www.jetbrains.com/idea/download/).
- Use Community Edition. (Scroll down a bit)
## Downloading SkyHanni source code
- Create an account on GitHub
- Go to https://github.com/hannibal002/SkyHanni
- Click on the Fork button to create a fork
- Leave the settings unchanged
- Click on "create fork"
- Open IntelliJ
- Log in into your GitHub account with intellij
- Go to "new" -> "project from version control"
- Select SkyHanni from the list
- Open the project
## Setting up IntelliJ
SkyHannis' gradle configuration is very similar to the one used in **NotEnoughUpdates**, you can just follow their
guide:
https://github.com/NotEnoughUpdates/NotEnoughUpdates/blob/master/CONTRIBUTING.md
# Software Used in SkyHanni
## Core
SkyHanni is a Forge mod for Minecraft 1.8.9, written in [Kotlin](https://kotlinlang.org/)
and [Java](https://www.java.com/en/).
We use a [gradle config](https://gradle.org/) to build the mod,
written in [Kotlin DSL](https://docs.gradle.org/current/userguide/kotlin_dsl.html):
[build.gradle.kts](https://github.com/hannibal002/SkyHanni/blob/beta/build.gradle.kts)
This start script will download all required libraries automatic.
## NotEnoughUpdates
SkyHanni requires NEU.
We use NEU to get auction house and bazaar price data for items, and to read
the [NEU Item Repo](https://github.com/NotEnoughUpdates/NotEnoughUpdates-REPO) for recipe and basic
For more info see https://github.com/NotEnoughUpdates/NotEnoughUpdates
## Config
Skyhanni uses the config system from NEU.
For more info see https://github.com/NotEnoughUpdates/MoulConfig
## Mixin
A system to inject code into original minecraft code.
This library is not part of SkyHanni itself, it comes preinstalled with forge.
For more info see https://github.com/SpongePowered/Mixin.
## Repo
SkyHanni uses a repo system to easily change static variables without the need for a mod update.
The repo is located at https://github.com/hannibal002/SkyHanni-REPO.
A copy of all files in the repo is stored for every SkyHanni user under `.minecraft\config\skyhanni\repo`
On every game start, the copy gets updated (if outdated, and if not manually disabled)
When working with the repo, it is recommended to disable the manual repo update to prevent to override your local
changes by acident.
# Coding Styles and Conventions
- Follow the [Hypixel Rules](https://hypixel.net/rules).
- Use the coding conventions for [Kotlin](https://kotlinlang.org/docs/coding-conventions.html)
and [Java](https://www.oracle.com/java/technologies/javase/codeconventions-contents.html).
- Do not copy features from other mods. Exceptions:
- Paid only mods.
- Mods that have reached the end of life. (Rip SBA, Dulkir, Soopy)
- The mod has, according to hypixel rules, illegal features ("cheat mod").
- If you can meainingfully imrpove upon the existing feature.
- All classes should be written in Kotlin, with few exceptions:
- Config files in `at.hannibal2.skyhanni.config.features`
- Mixin classes in `at.hannibal2.skyhanni.mixins.transformers`
- Java classes that represent json data objects in `at.hannibal2.skyhanni.utils.jsonobjects`
- Please use the existing event system, or expand on it.
- We inject the calls with mixins, and avoid using forge events.
- Please use existing utils methods.
- We try to avoid calling NEU code too often. We plan to remove the dependency to NEU in the future.
- We try to not use forge specific methods if possible. We plan to switch to gradle and minecraft 1.20 in the future.
# Additional Useful Developement Tools
## Dev Auth
[Dev Auth](https://github.com/DJtheRedstoner/DevAuth) is a tool that allows you to log in to your Minecraft account
inside IntelliJ. That way you can
debug and test code live on Hypixel, without the need to compile a jar, move it into a mods folder and start the
Minecraft launcher manually.
- Gradle already downloads dev auth for you.
- You only need to create a configuration folder:
- Navigate to `C:\Users\<your username>`
- Create a new folder `.devauth`
- Navigate to `C:\Users\<your username>\.devauth`
- Create a new file `config.toml`
- Paste this text in the file: (Don't change anyhting)
```
defaultEnabled = true
defaultAccount = "main"
[accounts.main]
type = "microsoft"
```
- Start Minecraft inside IntelliJ normal.
- You should see a link in the console.
- Click on the link, verify yourself with the mojang account.
- You are done. The verify process will reappear every couple of days (as your session token does expire)
## Hot Swapping
What is Hot Swapping? This allows you to reload edited code while debugging to remove the need to restart
the whole game every time.
We use [dcevm](https://dcevm.github.io/) and the IntelliJ
Plugin [HotSwap Agent](https://plugins.jetbrains.com/plugin/9552-hotswapagent) to quickly reload code changes.
Follow this tutorial:
https://forums.Minecraftforge.net/topic/82228-1152-3110-intellij-and-gradlew-forge-hotswap-and-dcevm-tutorial/
|
