Skip to content

Commit 09ed2ce

Browse files
committed
Documentation for players added.
Signed-off-by: Pavel Erokhin (MairwunNx) <MairwunNx@gmail.com>
1 parent cd098cd commit 09ed2ce

2 files changed

Lines changed: 226 additions & 74 deletions

File tree

documentation/for-players.md

Lines changed: 226 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,226 @@
1+
> ## Installation instructions.
2+
3+
For start the modification, you need installed Forge, it is desirable that the version matches the supported versions. You can download Forge from the [link](https://files.minecraftforge.net/maven/net/minecraftforge/forge/index_1.14.4.html).
4+
Move the downloaded mod to the `mods` folder (installation example below).
5+
6+
Also do not forget to install dependencies, only two types of dependencies
7+
- mandatory (game will not start without a mod)
8+
- recommended (without a mod, game can start, but I recommend using it)
9+
10+
Downloads: [Cooldown](https://github.com/ProjectEssentials/ProjectEssentials-Cooldown) · [Core](https://github.com/ProjectEssentials/ProjectEssentials-Core) · [Permissions](https://github.com/ProjectEssentials/ProjectEssentials-Permissions)
11+
12+
```
13+
.
14+
├── assets
15+
├── config
16+
├── libraries
17+
├── mods (that's how it should be)
18+
│ ├── Project Essentials Core-MOD-1.14.4-1.X.X.X.jar (mandatory)
19+
│ ├── Project Essentials Cooldown-1.14.4-1.X.X.X.jar (recommended)
20+
│ ├── Project Essentials Permissions-1.14.4-1.X.X.X.jar (recommended)
21+
│ └── Project Essentials Warps-1.14.4-1.X.X.X.jar
22+
└── ...
23+
```
24+
25+
Now try to start the game, go to the `mods` tab, if this modification is displayed in the `mods` tab, then the mod has been successfully installed.
26+
27+
### Control your warps via Minecraft commands
28+
29+
```
30+
/warp <warp name>
31+
32+
- description: base command of warps module; just teleport you to target warp point.
33+
34+
- permission: ess.warp
35+
```
36+
37+
```
38+
/setwarp <warp name>
39+
40+
- description: set new warp point and now it warp point pnly owned by you.
41+
42+
- permission: ess.warp.set
43+
```
44+
45+
```
46+
/delwarp <warp name>
47+
48+
- description: remove named warp point.
49+
50+
- note: only warp owner can remove target warp point!
51+
52+
- permission: ess.warp.remove
53+
```
54+
55+
### Configuration
56+
57+
Just in case. Default configuration.
58+
59+
You can get default configuration by removing file in path `.minecraft/config/ProjectEssentials/warps.json`, while mod loading if configuration file not exists it ll be recreated.
60+
61+
```json
62+
{
63+
"addResistanceEffect": true,
64+
"resistanceEffectDuration": 200,
65+
"enableTeleportSound": true,
66+
"enableTeleportEffect": true,
67+
"warps": []
68+
}
69+
```
70+
71+
### Describing configuration
72+
73+
```
74+
Property name: addResistanceEffect
75+
76+
Accepts data type: Boolean
77+
78+
Description: if value true, then after teleport to any warp, you'll get resistance effect. Basically it needed for protecting player from griefing.
79+
```
80+
81+
```
82+
Property name: resistanceEffectDuration
83+
84+
Accepts data type: Int
85+
86+
Description: make influence on resistance effect duration. (value accepts NOT AS SECONDS, in minecraft ticks)
87+
```
88+
89+
```
90+
Property name: enableTeleportSound
91+
92+
Accepts data type: Boolean
93+
94+
Description: if value true, then after teleport to any warp, you'll hear teleport sound.
95+
```
96+
97+
```
98+
Property name: enableTeleportEffect
99+
100+
Accepts data type: Boolean
101+
102+
Description: if value true, then after teleport to any warp, you'll see teleport effect (portal effect, like enderman teleporting effect).
103+
```
104+
105+
```
106+
Property name: warps
107+
108+
Accepts data type: Array with type Warp
109+
110+
Description: contains all warps (Warp Model).
111+
112+
See: `Describing Warp model`
113+
```
114+
115+
### Describing Warp model
116+
117+
```
118+
Property name: name
119+
120+
Accepts data type: String
121+
122+
Description: warp name.
123+
```
124+
125+
```
126+
Property name: clientWorld
127+
128+
Accepts data type: String
129+
130+
Description: client world name.
131+
```
132+
133+
```
134+
Property name: owner
135+
136+
Accepts data type: String
137+
138+
Description: warp creator nickname.
139+
```
140+
141+
```
142+
Property name: worldId
143+
144+
Accepts data type: Int
145+
146+
Description: minecraft world id.
147+
```
148+
149+
```
150+
Property name: xPos
151+
152+
Accepts data type: Int
153+
154+
Description: warp position by X axis.
155+
```
156+
157+
```
158+
Property name: yPos
159+
160+
Accepts data type: Int
161+
162+
Description: warp position by Y axis.
163+
```
164+
165+
```
166+
Property name: zPos
167+
168+
Accepts data type: Int
169+
170+
Description: warp position by Z axis.
171+
```
172+
173+
```
174+
Property name: yaw
175+
176+
Accepts data type: Float
177+
178+
Description: player camera rotation yaw.
179+
```
180+
181+
```
182+
Property name: pitch
183+
184+
Accepts data type: Float
185+
186+
Description: player camera rotation pitch.
187+
```
188+
189+
### Complete configuration example
190+
191+
It just for example, for understanding configuration structure.
192+
193+
```json
194+
{
195+
"addResistanceEffect": true,
196+
"resistanceEffectDuration": 200,
197+
"enableTeleportSound": true,
198+
"enableTeleportEffect": true,
199+
"warps": [
200+
{
201+
"name": "MyWarp",
202+
"clientWorld": "New World",
203+
"owner": "MairwunNx",
204+
"worldId": 0,
205+
"xPos": 1094,
206+
"yPos": 91,
207+
"zPos": 520,
208+
"yaw": 178.35184,
209+
"pitch": 43.199905
210+
},
211+
{
212+
"name": "MyWarp1",
213+
"clientWorld": "New World",
214+
"owner": "MairwunNx",
215+
"worldId": 0,
216+
"xPos": 1093,
217+
"yPos": 91,
218+
"zPos": 520,
219+
"yaw": 265.3518,
220+
"pitch": 4.6499176
221+
}
222+
]
223+
}
224+
```
225+
226+
### If you have any questions or encounter a problem, be sure to open an [issue](https://github.com/ProjectEssentials/ProjectEssentials-Warps/issues/new/choose)!

documentation/in-using.md

Lines changed: 0 additions & 74 deletions
This file was deleted.

0 commit comments

Comments
 (0)