@@ -250,29 +250,37 @@ bukkit {
250
250
251
251
# # Migration Guide
252
252
253
- # ## Upgrade from 0.8 .x
253
+ # ## Upgrade from 0.10 .x
254
254
255
- 1. Update gradle to 6.6 or newer :
256
- ` ` ` shell
257
- $ ./gradlew wrapper --gradle-version 6.7.1
258
- ` ` `
259
- 1. Use syntax `.set` in `bukkit.meta` instead of `=` :
255
+ 1. Update Gradle to 8.0 or newer (the latest version is recommended) :
256
+ ` ` ` shell
257
+ ./gradlew wrapper --gradle-version 8.13
258
+ ` ` `
259
+
260
+ 2. Replace deprecated and removed APIs :
260
261
` ` ` diff
261
262
bukkit {
262
- meta {
263
- - desctiption = "My plugin's description"
264
- + description.set("My plugin's description")
263
+ - meta {
264
+ + plugin {
265
+ name = "MyPlugin"
266
+ - url = "https://example.com/"
267
+ + website = "https://example.com/"
265
268
}
266
269
}
267
- ` ` `
270
+ ` ` `
271
+
272
+ 3. If you have `plugin.yml`, move it's content to `bukkit.plugin { ... }` block
273
+
274
+ # ## Upgrade from 0.8.x
275
+
268
276
1. Use `bukkit.apiVersion` instead of `bukkit.version` :
269
277
` ` ` diff
270
278
bukkit {
271
279
- version = "1.16.4"
272
280
+ apiVersion = "1.16.4"
273
281
}
274
282
` ` `
275
- 1 . Use `build.server` block instead of `build.run` :
283
+ 2 . Use `build.server` block instead of `build.run` :
276
284
` ` ` diff
277
285
bukkit {
278
286
- run {
@@ -281,7 +289,7 @@ bukkit {
281
289
}
282
290
}
283
291
` ` `
284
- 1 . Update arguments assignment syntax :
292
+ 3 . Update arguments assignment syntax :
285
293
` ` ` diff
286
294
bukkit {
287
295
server {
@@ -291,7 +299,7 @@ bukkit {
291
299
}
292
300
}
293
301
` ` `
294
- 1 . Replace removed APIs :
302
+ 4 . Replace removed APIs :
295
303
` ` ` diff
296
304
repositories {
297
305
- destroystokyo()
@@ -306,8 +314,8 @@ bukkit {
306
314
+ compileOnly(spigot())
307
315
}
308
316
` ` `
309
- 1 . Remove `q` and `qq` functions calls in `meta { ... }`
310
- 1 . Check generated plugin.yml contents after build.
317
+ 5 . Remove `q` and `qq` functions calls in `meta { ... }`
318
+ 6 . Check generated plugin.yml contents after build.
311
319
312
320
If there are any problems, [create an issue][issue].
313
321
0 commit comments