From 33be942176c5cf8085732ed87e24d92dda85deb4 Mon Sep 17 00:00:00 2001 From: Alexander Brandes Date: Sun, 9 Oct 2022 16:41:22 +0200 Subject: [PATCH] [ci skip] Rewrite README for modrinth (#1979) docs: Rewrite README for modrinth --- .gitignore | 1 - README.adoc | 47 --------------- README.md | 95 +++++++++++++++++++++++++++++++ worldedit-bukkit/build.gradle.kts | 1 + 4 files changed, 96 insertions(+), 48 deletions(-) delete mode 100644 README.adoc create mode 100644 README.md diff --git a/.gitignore b/.gitignore index 9640418d6..14ba6416a 100644 --- a/.gitignore +++ b/.gitignore @@ -24,7 +24,6 @@ logs/ worldedit-bukkit/src/main/java/ignore/* todo.txt mvn/* -docs/ *.sh # i18n worldedit-core/src/main/resources/lang/* diff --git a/README.adoc b/README.adoc deleted file mode 100644 index 58af413a5..000000000 --- a/README.adoc +++ /dev/null @@ -1,47 +0,0 @@ -image::https://raw.githubusercontent.com/IntellectualSites/Assets/main/plugins/FastAsyncWorldEdit/FastAsyncWorldEdit.svg[200,200,align=center] - -''' - -FastAsyncWorldEdit is a fork of WorldEdit that has huge speed and memory improvements and considerably more features - -== A Minecraft Map Editor... that runs in-game! - -* With selections, schematics, copy and paste, brushes, and scripting! -* Use it in creative, survival in single player or on your server. -* Use it on your Minecraft server to fix grieving and mistakes. - -Java Edition required. FastAsyncWorldEdit is compatible with Bukkit, Spigot and Paper. - -=== Download FastAsyncWorldEdit -* Snapshot builds: https://ci.athion.net/job/FastAsyncWorldEdit/ -* Spigot: https://www.spigotmc.org/resources/fast-async-worldedit.13932/ -* Older, unsupported, versions: https://intellectualsites.github.io/download/fawe.html - -=== Links - -* link:https://discord.gg/intellectualsites[Discord] -* link:https://intellectualsites.github.io/fastasyncworldedit-documentation/[Wiki] -* link:https://github.com/IntellectualSites/FastAsyncWorldEdit/issues[Report Issue] -* link:https://intellectualsites.github.io/fastasyncworldedit-javadocs/[Javadocs] -* link:https://intellectualsites.crowdin.com/fastasyncworldedit[Crowdin (Translations)] - -=== Edit The Code - -Want to add new features to FastAsyncWorldEdit or fix bugs yourself? You can get the game running, with FastAsyncWorldEdit, from the code here: - -For additional information about compiling FastAsyncWorldEdit, see link:COMPILING.adoc[COMPILING.adoc]. - -=== Submitting Your Changes -FastAsyncWorldEdit is open source (specifically licensed under GPL v3), so note that your contributions will also be open source. The best way to submit a change is to create a fork on GitHub, put your changes there, and then create a "pull request" on our FastAsyncWorldEdit repository. - -Please read link:https://github.com/IntellectualSites/.github/blob/main/CONTRIBUTING.md[CONTRIBUTING.md] for important guidelines to follow. - -=== Special thanks to: -image::https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg[150,150] -link:https://jb.gg/OpenSourceSupport[JetBrains], creators of the IntelliJ IDEA, supports us with their Open Source Licenses. - -image::https://www.yourkit.com/images/yklogo.png[200,200,align=left] - -Thank you to YourKit for supporting our product by providing us with their innovative and intelligent tools -for monitoring and profiling Java and .NET applications. -YourKit is the creator of link:https://www.yourkit.com/java/profiler/[YourKit Java Profiler], link:https://www.yourkit.com/.net/profiler/[YourKit .NET Profiler], and link:https://www.yourkit.com/youmonitor/[YourKit YouMonitor]. diff --git a/README.md b/README.md new file mode 100644 index 000000000..ed012e6b5 --- /dev/null +++ b/README.md @@ -0,0 +1,95 @@ +# FastAsyncWorldEdit +[![Join us on Discord](https://img.shields.io/discord/268444645527126017.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/intellectualsites) +[![bStats Servers](https://img.shields.io/bstats/servers/1403)](https://bstats.org/plugin/bukkit/FastAsyncWorldEdit/1403) +[![Crowdin](https://badges.crowdin.net/e/4a5819fae3fd88234a8ea13bfbb072bb/localized.svg)](https://intellectualsites.crowdin.com/fastasyncworldedit) + +## What is FAWE and why should I use it? + +FAWE is designed for efficient world editing. +* Simple to set up and use +* Extremely configurable +* Uses minimal CPU/Memory +* Safe for many players to use +* Insanely fast, when using the slowest mode + +FastAsyncWorldEdit is a fork of WorldEdit that has huge speed and memory improvements and considerably more features. +If you use other plugins which depend on WorldEdit, simply having FAWE installed will boost their performance. + +## Downloads + +Downloads are available either on SpigotMC, Modrinth or on CurseForge. +- [SpigotMC](https://www.spigotmc.org/resources/13932/) +- [Modrinth](https://modrinth.com/plugin/fastasyncworldedit/) +- [CurseForge](https://dev.bukkit.org/projects/fawe) + +Snapshots are available on [Jenkins](https://ci.athion.net/job/FastAsyncWorldEdit/). + +## Features + +* Over 200 Commands +* Style and translate messages and commands +* (No setup required) Clipboard web integration (Clipboard) +* Unlimited //undo, per world history, instant lookups/rollback and cross server clipboards +* Advanced per player limits (entity, tiles, memory, changes, iterations, regions, inventory) +* Visualization, targeting modes/masks and scroll actions +* Adds lots of powerful new //brushes and //tools. +* Adds a lot more mask functionality. (new mask syntax, patterns, expressions, source masks) +* Adds a lot more pattern functionality. (a lot of new pattern syntax and patterns) +* Adds edit transforms (apply transforms to a source, e.g. on //paste) +* Adds support for new formats (e.g. Structure Blocks) +* Instant copying of arbitrary size with `//lazycopy` +* Auto repair partially corrupt schematic files +* Biome mixing, in-game world painting, dynamic view distance, vanilla cui, off axis rotation, image importing, cave generation, + multi-clipboards, interactive messages, schematic visualization, lag prevention, persistent brushes + A LOT MORE + +### Performance + +There are several placement modes, each supporting higher throughput than the previous. All editing is processed +asynchronously, with +certain tasks being broken up on the main thread. The default mode is chunk placement. +* Blocks (Bukkit-API) - Only used if chunk placement isn't supported. Still faster than any other plugin on spigot. +* Chunks (NMS) - Places entire chunk sections +* World (CFI) - Used to generate new worlds / regions + +### Protection Plugins + +The following plugins are supported with Bukkit: +* [WorldGuard](https://dev.bukkit.org/projects/worldguard) +* [PlotSquared](https://www.spigotmc.org/resources/77506/) + +### Logging and Rollback + +By default you can use `//inspect` and `//history rollback` to search and restore changes. To reduce disk usage, increase the +compression level and buffer size. To bypass logging use `//fast`. + +### Developer API + +FAWE maintains API compatibility with WorldEdit, so you can use the normal WorldEdit API asynchronously. +FAWE also has some asynchronously wrappers for the Bukkit API. +The wiki has examples for various things like reading NBT, modifying world files, pasting schematics, splitting up tasks, lighting etc. +If you need help with anything, hop on discord (link on the left bar). + +## Documentation + +* [Wiki](https://intellectualsites.github.io/fastasyncworldedit-documentation/) +* [Javadocs](https://intellectualsites.github.io/fastasyncworldedit-javadocs/) + +## Contributing + +Want to add new features to FastAsyncWorldEdit or fix bugs yourself? You can get the game running, with FastAsyncWorldEdit, from the code here: + +For additional information about compiling FastAsyncWorldEdit, read the [compiling documentation](https://github.com/IntellectualSites/FastAsyncWorldEdit/blob/main/COMPILING.adoc). + +## Special thanks + + + + +[JetBrains](https://jb.gg/OpenSourceSupport), creators of the IntelliJ IDEA, supports us with their Open Source Licenses. + + + + +Thank you to YourKit for supporting our product by providing us with their innovative and intelligent tools +for monitoring and profiling Java and .NET applications. +YourKit is the creator of [YourKit Java Profiler](https://www.yourkit.com/java/profiler/), [YourKit .NET Profiler](https://www.yourkit.com/.net/profiler/), and [YourKit YouMonitor](https://www.yourkit.com/youmonitor/). diff --git a/worldedit-bukkit/build.gradle.kts b/worldedit-bukkit/build.gradle.kts index 8f61e8c08..90122c4fa 100644 --- a/worldedit-bukkit/build.gradle.kts +++ b/worldedit-bukkit/build.gradle.kts @@ -201,5 +201,6 @@ tasks { loaders.addAll(listOf("paper", "purpur", "spigot")) changelog.set("The changelog is available on GitHub: https://github.com/IntellectualSites/" + "FastAsyncWorldEdit/releases/tag/${project.version}") + syncBodyFrom.set(rootProject.file("README.md").readText()) } }