Skip to content

Commit eec7d3b

Browse files
committed
Refer to wiki for documentation
This will reduce the number of commits (and merges between version branches) needed as we update & improve our docs.
1 parent bb488d7 commit eec7d3b

File tree

5 files changed

+13
-31
lines changed

5 files changed

+13
-31
lines changed

build-logic/src/main/kotlin/io/papermc/mache/tasks/CopyVersion.kt

+2-2
Original file line numberDiff line numberDiff line change
@@ -18,11 +18,11 @@ import org.gradle.api.tasks.options.Option
1818
@UntrackedTask(because = "CLI command")
1919
abstract class CopyVersion : DefaultTask() {
2020

21-
@get:Option(option = "from-version", description = "The version to copy")
21+
@get:Option(option = "from", description = "The version to copy")
2222
@get:Input
2323
abstract val fromVersion: Property<String>
2424

25-
@get:Option(option = "to-version", description = "The target version")
25+
@get:Option(option = "to", description = "The target version")
2626
@get:Input
2727
abstract val toVersion: Property<String>
2828

build-logic/src/main/kotlin/io/papermc/mache/tasks/MigrateVersion.kt

+2-2
Original file line numberDiff line numberDiff line change
@@ -23,11 +23,11 @@ import org.gradle.api.tasks.options.Option
2323
@UntrackedTask(because = "CLI command, always migrate")
2424
abstract class MigrateVersion : DefaultTask() {
2525

26-
@get:Option(option = "from-version", description = "The version to migrate.")
26+
@get:Option(option = "from", description = "The version to migrate.")
2727
@get:Input
2828
abstract val fromVersion: Property<String>
2929

30-
@get:Option(option = "to-version", description = "The new version to migrate to.")
30+
@get:Option(option = "to", description = "The new version to migrate to.")
3131
@get:Input
3232
abstract val toVersion: Property<String>
3333

build-logic/src/main/kotlin/io/papermc/mache/tasks/OpenVersion.kt

+1-1
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ import org.gradle.api.tasks.options.Option
4141
abstract class OpenVersion : DefaultTask() {
4242

4343
@get:Input
44-
@get:Option(option = "version-name", description = "The version to open.")
44+
@get:Option(option = "ver", description = "The version to open.")
4545
abstract val versionName: Property<String>
4646

4747
@get:Input

build.gradle.kts

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ val mcManifestUrl = "https://piston-meta.mojang.com/mc/game/version_manifest_v2.
1313
val mcManifestFile: RegularFile = layout.dotGradleDirectory.file(MC_MANIFEST)
1414
download.download(mcManifestUrl, mcManifestFile)
1515

16-
tasks.register("openVersion", OpenVersion::class) {
16+
tasks.register("open", OpenVersion::class) {
1717
repoUrl.set(REPO_URL)
1818
}
1919

readme.md

+7-25
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Mâché
22
=====
33

4-
Mache (from [papier-mâché](https://en.wikipedia.org/wiki/Papier-m%C3%A2ch%C3%A9)) is an environment which aims to
4+
Mâché (from [papier-mâché](https://en.wikipedia.org/wiki/Papier-m%C3%A2ch%C3%A9)) is an environment which aims to
55
provide a clean-slate, fully compilable and workable decompiled Minecraft server source code. This serves as the base
66
for the PaperMC Minecraft server project, of which Paper's patches will apply to it. This can of course also be used by
77
anyone else who wants to use it for their own purposes.
@@ -16,36 +16,18 @@ Goal
1616
The current goal of this project is to provide the Minecraft source set as un-modified as possible. The patches present
1717
are only for allowing the decompiled code to be re-compilable. We may still end up publishing additional builds for a
1818
single Minecraft version, however, as we bring in updates from [codebook](https://github.com/PaperMC/codebook),
19-
[VineFlower](https://github.com/Vineflower/vineflower), or [Parchment](https://github.com/ParchmentMC/Parchment).
19+
[VineFlower](https://github.com/Vineflower/vineflower),
20+
[AutoRenamingTool](https://github.com/neoforged/AutoRenamingTool) or
21+
[Parchment](https://github.com/ParchmentMC/Parchment).
2022

2123
The Minecraft sources generated here use Mojang's official mappings, and we use Parchment mappings for parameter name
2224
mappings. Local variable mappings are generated at remap time via
2325
[codebook](https://github.com/PaperMC/codebook).
2426

25-
Usage
26-
-----
27+
Documentation
28+
-------------
2729

28-
Set up all present versions:
29-
```sh
30-
./gradlew setup
31-
```
32-
33-
Set up a specific version:
34-
```sh
35-
./gradlew :versions:1.20.1:setup
36-
```
37-
38-
Patches
39-
-------
40-
41-
If you make changes, you can re-build patches with:
42-
```sh
43-
./gradlew :versions:1.20.1:rebuildPatches
44-
```
45-
46-
You may notice that the source set directory for each version is also its own tiny git repository. This repo is not used
47-
at all in the process of generating or applying patches, it exists solely to improve the developer experience, making it
48-
easier to view your current changes, and the changes pulled in from the existing patches.
30+
[See the wiki for docs on usage and further details.](https://github.com/PaperMC/mache/wiki)
4931

5032
License
5133
-------

0 commit comments

Comments
 (0)