diff --git a/docs/about/NOTE-FROM-EVA.html b/docs/about/NOTE-FROM-EVA.html new file mode 100644 index 0000000000..23eff7268c --- /dev/null +++ b/docs/about/NOTE-FROM-EVA.html @@ -0,0 +1,175 @@ + + + +About Copper Launcher — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

About Copper Launcher

+

Origins

+

Copper Launcher is a fork of Amethyst, which itself is a continuation of PojavLauncher — one of the most well-known open source Minecraft: Java Edition launchers for Android.

+

The goal of Copper Launcher is to polish and extend what came before: better performance, improved mod support, a fresh theme, and a more welcoming community experience.

+

Why "Copper"?

+

Copper is a material that ages, evolves, and oxidizes over time — much like this project. It starts raw and gets refined.

+

Our Values

+ +

Acknowledgements

+

Copper Launcher would not exist without the PojavLauncher Team and the AngelAuraMC / Amethyst team, as well as every contributor, translator, tester, and community member.

+

Get Involved

+ + +
+
+ + + + + \ No newline at end of file diff --git a/docs/contribute/CONT-WEBSITE.html b/docs/contribute/CONT-WEBSITE.html new file mode 100644 index 0000000000..3a91f54fba --- /dev/null +++ b/docs/contribute/CONT-WEBSITE.html @@ -0,0 +1,183 @@ + + + +Contributing — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Contributing to Copper Launcher

+

Thank you for your interest in contributing! Here's how to get started.

+

Ways to Contribute

+ +

Wiki Structure

+

The wiki is a static HTML site. Each page corresponds to a file in the docs/ folder of the repository, mirroring the URL structure.

+

Submitting Changes

+
    +
  1. Fork the repository.
    2. +
  2. Create a branch: git checkout -b my-wiki-edit
    3. +
  3. Make your changes and commit them.
    4. +
  4. Open a pull request against main.
    5. +
+

Style Guidelines

+ +

Questions? Ask on Discord.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/contribute/CONT-WIKI.html b/docs/contribute/CONT-WIKI.html new file mode 100644 index 0000000000..68cb08245f --- /dev/null +++ b/docs/contribute/CONT-WIKI.html @@ -0,0 +1,171 @@ + + + +Wiki Contributing — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Contributing to the Wiki

+

This page covers how to write and edit wiki content specifically. For general contributing info, see Contributing.

+

What Can I Contribute?

+ +

Writing Good Wiki Pages

+

Headers

+

Use <h1> for page title, <h2> for major sections, <h3> for subsections.

+

Tips and Warnings

+

Use the tip, warning, or danger CSS classes on a <div> for callout boxes — as seen throughout this wiki.

+

Need Help?

+

Ask on Discord or open a GitHub issue.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/index.html b/docs/index.html deleted file mode 100644 index 6ef8c937a3..0000000000 --- a/docs/index.html +++ /dev/null @@ -1,983 +0,0 @@ - - - - - - Copper Launcher - - - - - - - - - - -
-
-
-
Now Available
-

Copper Launcher

-

- A powerful Minecraft: Java Edition launcher for Android, built on Amethyst. - Play every version, mod freely, and carry your world in your pocket. -

-
- - - Download APK - - - - View on GitHub - -
- - -
- Copper Launcher screenshot -
-
-
- - -
-

Available on

-
-
- - iOS (coming soon) -
-
- - Android -
-
- - Open Source (LGPL-3.0) -
-
-
- -
- - -
-
-

Why Copper

-

Everything you need to play

-

Built on the shoulders of giants — Amethyst and PojavLauncher — with extra polish and features.

-
- -
-
-
⚙️
-

Full Java Edition

-

Play Minecraft: Java Edition from rd-132211 all the way up to the latest 1.21 snapshots and Combat Test versions.

-
-
-
🔧
-

Mod Support

-

Forge and Fabric supported out of the box. Install mods directly or via a headless installer for full modded gameplay.

-
-
-
🎨
-

Custom Themes

-

Copper ships with a fresh new theme and supports customization to make the launcher truly your own.

-
-
-
🚀
-

Performance Mods

-

Sodium and Krypton Wrapper are baked in for dramatically improved rendering performance on mobile hardware.

-
-
-
🖥️
-

Modern OpenJDK

-

Ships with OpenJDK 8, 17, and 21 — multi-architecture support for ARM32, ARM64, x86, and x86_64 devices.

-
-
-
🌍
-

Translated

-

Community-powered localization via Crowdin means Copper speaks your language, wherever you are.

-
-
-
🎮
-

Rewritten Controls

-

The entire controls system has been rebuilt from the ground up with native code, providing a responsive and natural feel.

-
-
-
🔊
-

OpenAL Audio

-

Full OpenAL audio support works on most Android devices, keeping your Minecraft experience immersive.

-
-
-
🔓
-

Free & Open Source

-

Licensed under GNU LGPLv3. Inspect, fork, and contribute — the code is yours to explore on GitHub.

-
-
-
- - -
-
-
-

Mod Management

-

Forge & Fabric, natively

-

Installing mods on mobile used to be painful. Copper integrates a full mod installer — both with and without GUI — so you can load up your favourite modpacks and get playing in minutes.

-
- Forge - Fabric - Headless Installer - Modrinth - CurseForge -
-
-
- Mod management -
-
- -
-
-

Performance

-

Play smooth on any device

-

Copper integrates Sodium, Krypton Wrapper, and MobileGlues rendering to squeeze every frame out of your Android hardware. Even older devices can experience buttery-smooth gameplay.

-
- Sodium - Krypton Wrapper - GL4ES - MobileGlues - LTW -
-
-
- Minecraft gameplay on Android -
-
- -
-
-

Version Support

-

Every version, ever made

-

From the very first Minecraft test builds to the latest snapshots and experimental Combat Tests — if Mojang shipped it, Copper can run it. All major Java Edition milestones are supported.

-
- 1.7 – 1.21 - Snapshots - Combat Tests - Legacy Versions -
-
-
-
-
rd-132211
-
all the way to
-
1.21+
-
-
-
-
- -
- - -
-
-
-

Compatibility

-

Current Status

-

Copper supports a wide range of architectures and feature sets. Here's what's working today.

-
- -
-
OpenJDK 8 · ARM32
-
OpenJDK 8 · ARM64
-
OpenJDK 8 · x86
-
OpenJDK 8 · x86_64
-
OpenJDK 17 · ARM32
-
OpenJDK 17 · ARM64
-
OpenJDK 17 · x86
-
OpenJDK 17 · x86_64
-
OpenJDK 21 · ARM64
-
OpenJDK 21 · x86_64
-
Minecraft 1.12.2 and below
-
Minecraft 1.13+
-
Minecraft 1.17 / 22w13a+
-
OpenAL Audio
-
OpenGL (via GL4ES)
-
Game Surface Zooming
-
Forge Installer
-
Fabric Installer
-
Sodium Support
-
iOS (in progress)
-
-
-
- -
- - -
-
-

Get Started

-

Download Copper

-

Choose your preferred method to get Copper on your Android device.

-
- -
- -
📦
-

Stable Release

-

Latest tested build from GitHub Releases

- Download Latest - - -
🌙
-

Nightly Build

-

Latest automated build via Nightly.link

- Download Nightly - - -
🔨
-

Build from Source

-

Compile it yourself using Gradle

- View Instructions - -
- -

- Not affiliated with Mojang or Microsoft. You don't need own a valid Minecraft: As we support local and premium accounts to use Copper Launcher. -

-
- -
- - -
-
-

Community

-

Get Involved

-

Copper is open source and community-driven. Join us, report bugs, translate, or contribute code.

-
- -
- - - Discord Server - - - - Source Code - - - - Issue Tracker - - - - Help Translate - - - - Modrinth - -
-
- - - - - - diff --git a/docs/patchnotes/changelogs/ANDROID.html b/docs/patchnotes/changelogs/ANDROID.html new file mode 100644 index 0000000000..83b87d9c66 --- /dev/null +++ b/docs/patchnotes/changelogs/ANDROID.html @@ -0,0 +1,186 @@ + + + +Android Changelog — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Android Changelogs

+

v3.x (Current — OpenJDK Branch)

+

Latest Nightly

+ +

v2.x (Legacy)

+

v2.5.x

+ +

v2.4.x

+ +

Downloads

+

Nightly builds: Nightly.link

+

Stable releases: GitHub Releases

+

Nightly builds may be unstable. Use stable releases for everyday play.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/patchnotes/changelogs/IOS.html b/docs/patchnotes/changelogs/IOS.html new file mode 100644 index 0000000000..be11ac27a7 --- /dev/null +++ b/docs/patchnotes/changelogs/IOS.html @@ -0,0 +1,167 @@ + + + +iOS Changelog — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

iOS Changelogs

+

iOS support for Copper Launcher is currently in active development. This page will be updated as releases are made.

+

Status

+

iOS support is being worked on. Follow progress on GitHub and join the Discord for updates.

+

Planned Features

+ +

Check back here for updates as the iOS version develops.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/faq/android/FAQ-android.html b/docs/wiki/faq/android/FAQ-android.html new file mode 100644 index 0000000000..6bcf4355b9 --- /dev/null +++ b/docs/wiki/faq/android/FAQ-android.html @@ -0,0 +1,200 @@ + + + +Android FAQ — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

FAQ — Android

+

Installation

+

Where do I download Copper Launcher?

+ +

Why does Android block the installation?

+

You need to allow installation from unknown sources. See the Install guide.

+

Is Copper Launcher on the Play Store?

+

Not currently. Install via APK from GitHub.

+

Performance

+

The game runs slowly. What can I do?

+

See the Optimization Guide. Quick tips: lower render distance to 4–6 chunks, set Graphics to Fast, and allocate the right amount of RAM.

+

How much RAM should I allocate?

+ + + + + + +
Device RAMRecommended
3GB1–1.5GB
4GB1.5–2GB
6GB2–3GB
8GB+3–4GB
+

My device gets very hot. Is that normal?

+

Minecraft is CPU/GPU intensive. Some heat is expected. Enable Sustained Performance mode in launcher settings to reduce heat.

+

Crashes & Errors

+

The game crashes on launch. What do I do?

+
    +
  1. Check the crash log (tap Show Log in launcher settings).
    2. +
  2. Search GitHub Issues for your error.
    3. +
  3. Open a new issue with the full log attached if it's a new bug.
    4. +
+

"Java runtime not found" error

+

Go to Settings → Java Runtime and re-download the runtime for your architecture.

+

"OpenGL error" or black screen

+

Try switching the renderer in Settings → Renderer (e.g. GL4ES → MobileGlues).

+

Mods

+

Can I use mods with Copper Launcher?

+

Yes! See the Mods guide.

+

Which mod loaders are supported?

+

Forge and Fabric are both supported.

+

Other

+

Is Copper Launcher safe?

+

Yes. Copper Launcher is fully open source under LGPLv3. Inspect the code on GitHub.

+

I have a question not answered here.

+

Join the Discord server or open a GitHub Discussion.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/faq/ios/FAQ-ios.html b/docs/wiki/faq/ios/FAQ-ios.html new file mode 100644 index 0000000000..a14f4119cf --- /dev/null +++ b/docs/wiki/faq/ios/FAQ-ios.html @@ -0,0 +1,166 @@ + + + +iOS FAQ — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

FAQ — iOS

+

iOS support for Copper Launcher is still in development. This FAQ will be updated as the iOS version matures.

+

Is Copper Launcher available on iOS?

+

Not yet. iOS support is actively being developed. Follow progress on GitHub and Discord.

+

When will iOS be available?

+

There is no set release date. Check back on this wiki and the Discord for announcements.

+

Stay Updated

+ + +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/getting_started/CUSTOM-CONTROLS.html b/docs/wiki/getting_started/CUSTOM-CONTROLS.html new file mode 100644 index 0000000000..229fb3fd28 --- /dev/null +++ b/docs/wiki/getting_started/CUSTOM-CONTROLS.html @@ -0,0 +1,176 @@ + + + +Custom Controls — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Custom Controls

+

Copper Launcher features a fully rewritten controls system built in native code, giving you a responsive and customizable experience.

+

Opening the Controls Editor

+

While in-game, tap the gamepad icon in the top-right corner to open the controls editor. Alternatively, go to Settings → Controls → Edit Controls from the launcher home screen.

+

Control Types

+

Virtual Joystick

+

The left joystick controls movement. You can resize it, move it anywhere on screen, and toggle fixed vs. floating mode in control settings.

+

Buttons

+

Buttons can be added, moved, resized, and removed. Available actions include Jump, Sneak, Sprint, Attack, Use Item, Open Inventory, Drop Item, Chat, Perspective Toggle, and any keyboard key.

+

Mouse Mode

+

Enable Mouse Mode in the controls settings for a trackpad-style experience, useful for some Minecraft versions.

+

Importing / Exporting Controls

+
    +
  1. Open the controls editor.
    2. +
  2. Tap the Export button to save your layout as a .json file.
    3. +
  3. To import, tap Import and select a .json controls file.
    4. +
+

Platform Tips

+

Bluetooth controllers and USB OTG keyboards/mice are supported on Android. Copper Launcher uses standard Android gamepad mapping.

+

Resetting Controls

+

Open the controls editor → tap the menu icon (three dots) → select Reset to Default.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/getting_started/FIRST-LAUNCH.html b/docs/wiki/getting_started/FIRST-LAUNCH.html new file mode 100644 index 0000000000..5a4c79e904 --- /dev/null +++ b/docs/wiki/getting_started/FIRST-LAUNCH.html @@ -0,0 +1,191 @@ + + + +First Launch — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Your First Launch

+

Step 1 — Add an Account

+

On the home screen, tap the account icon (top right) or the Add Account button.

+

Microsoft / Premium Account

+
    +
  1. Tap Microsoft Login.
    2. +
  2. A browser window will open. Sign in with your Microsoft account linked to Minecraft.
    3. +
  3. Authorize Copper Launcher.
    4. +
  4. Your account will appear in the launcher.
    5. +
+

Local / Offline Account

+
    +
  1. Tap Local Account.
    2. +
  2. Enter a username of your choice.
    3. +
  3. Tap Confirm.
    4. +
+

Local accounts can play singleplayer and LAN games, but cannot join servers that require authentication.

+

Step 2 — Select a Minecraft Version

+
    +
  1. Tap the version selector on the home screen.
    2. +
  2. Browse or search for the version you want.
    3. +
  3. Tap the version to select it.
    4. +
+

If you're not sure which version to pick, 1.20.1 has the best mod support via Forge and Fabric.

+

Step 3 — Download and Launch

+
    +
  1. Tap Play (or Download if the version isn't installed yet).
    2. +
  2. Wait for Copper Launcher to download the game files.
    3. +
  3. The game will launch automatically once downloaded.
    4. +
+

Tips for First-Time Players

+ + +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/getting_started/INSTALL-android.html b/docs/wiki/getting_started/INSTALL-android.html new file mode 100644 index 0000000000..86a8e94abe --- /dev/null +++ b/docs/wiki/getting_started/INSTALL-android.html @@ -0,0 +1,190 @@ + + + +Install (Android) — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Installing Copper Launcher (Android)

+

Requirements

+ +

Copper Launcher supports ARM32, ARM64, x86, and x86_64. Most modern Android phones are ARM64.

+

Step 1 — Download the APK

+ + + + +
VersionLinkNotes
StableGitHub ReleasesRecommended for most users
NightlyNightly.linkLatest features, may be unstable
+

Step 2 — Allow Unknown Sources

+
    +
  1. Open Settings on your device.
    2. +
  2. Go to Apps (or Security, depending on your device).
    3. +
  3. Tap Install unknown apps.
    4. +
  4. Select your browser or file manager and enable Allow from this source.
    5. +
+

Remember to disable this setting after installation for security.

+

Step 3 — Install the APK

+
    +
  1. Open your Downloads folder.
    2. +
  2. Tap the APK file.
    3. +
  3. Tap Install when prompted.
    4. +
  4. Tap Open to launch Copper Launcher.
    5. +
+

Step 4 — First Launch

+

On first launch, Copper Launcher will ask for storage permissions and download the Java runtime for your device. Continue to Your First Launch to finish setup.

+

Troubleshooting

+

Installation blocked? Make sure you've enabled unknown sources (Step 2).

+

App crashes on launch? Try the latest nightly build, or report the issue on GitHub Issues.

+

Not enough storage? Free up at least 1–2GB for a smooth experience.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/getting_started/INSTALL-ios.html b/docs/wiki/getting_started/INSTALL-ios.html new file mode 100644 index 0000000000..596037e754 --- /dev/null +++ b/docs/wiki/getting_started/INSTALL-ios.html @@ -0,0 +1,165 @@ + + + +Install (iOS) — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Installing Copper Launcher (iOS)

+

iOS support for Copper Launcher is currently in development. This guide will be updated when an iOS release is available.

+

Current Status

+

The iOS version of Copper Launcher is actively being worked on and is not yet available for public download.

+

Stay Updated

+ +

Check back soon!

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/getting_started/LAUNCHER-PREFERENCES.html b/docs/wiki/getting_started/LAUNCHER-PREFERENCES.html new file mode 100644 index 0000000000..9098d1ca86 --- /dev/null +++ b/docs/wiki/getting_started/LAUNCHER-PREFERENCES.html @@ -0,0 +1,186 @@ + + + +Launcher Preferences — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Launcher Preferences

+

Tap the gear icon on the launcher home screen to open Settings.

+

Java Settings

+ + + + + +
SettingDescription
Java RuntimeChoose between OpenJDK 8, 17, or 21
Java ArgumentsCustom JVM arguments — see Java Arguments guide
RAM AllocationHow much RAM to give Minecraft (default: auto)
+

For Minecraft 1.17+, you must use Java 17 or higher. Copper Launcher selects this automatically.

+

Renderer Settings

+ + + + +
SettingDescription
RendererGL4ES (default), VirGL, MobileGlues
Renderer String OverrideSpoofs a different GPU string
+

Launcher Settings

+ + + + + +
SettingDescription
ThemeSwitch between Copper (default) and other themes
LanguageInterface language (Crowdin community translations)
Show LogShow the game log window during launch
+

Experimental Settings

+

Experimental settings may cause instability. Use with caution.

+ + + + + +
SettingDescription
Turbo ModeDisables frame limiting for maximum performance
Force VsyncForces vertical sync
Use alternate surfaceAlternative rendering surface (helps on some devices)
+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/going_further/ACCOUNTS.html b/docs/wiki/going_further/ACCOUNTS.html new file mode 100644 index 0000000000..d08fbe00c7 --- /dev/null +++ b/docs/wiki/going_further/ACCOUNTS.html @@ -0,0 +1,177 @@ + + + +Managing Accounts — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Managing Accounts

+

Copper Launcher supports both Microsoft (premium) accounts and local (offline) accounts.

+

Adding a Microsoft Account

+
    +
  1. On the launcher home screen, tap the account icon (top right).
    2. +
  2. Tap Add Account → Microsoft Login.
    3. +
  3. A browser window opens. Sign in with your Microsoft account.
    4. +
  4. Authorize Copper Launcher when prompted.
    5. +
+

You must own Minecraft: Java Edition on your Microsoft account to play on online servers.

+

Adding a Local / Offline Account

+
    +
  1. Tap the account icon.
    2. +
  2. Tap Add Account → Local Account.
    3. +
  3. Enter any username you like and tap Confirm.
    4. +
+

Local accounts cannot join online servers that require authentication. They can play singleplayer and LAN games.

+

Switching & Removing Accounts

+

To switch: tap the account icon, then tap the account you want. To remove: long-press the account and tap Remove.

+

Troubleshooting Login Issues

+

"Failed to login" error? Make sure you own Minecraft: Java Edition and try logging out and back in. Check status.xbox.com for Microsoft server issues.

+

Token expired? Tap the account and select Refresh Token, or remove and re-add the account.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/going_further/JAVA-ARGS.html b/docs/wiki/going_further/JAVA-ARGS.html new file mode 100644 index 0000000000..a68d69d9fc --- /dev/null +++ b/docs/wiki/going_further/JAVA-ARGS.html @@ -0,0 +1,180 @@ + + + +Java Arguments — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Java Arguments

+

Java arguments (JVM flags) let you fine-tune how Minecraft runs. Access them via Settings → Java Arguments.

+

Common Arguments Explained

+ + + + + + + + +
ArgumentEffect
-Xmx2GSets maximum heap size to 2GB
-Xms512MSets initial heap size to 512MB
-XX:+UseG1GCUse G1 garbage collector — better for Minecraft
-XX:MaxGCPauseMillis=200Target max GC pause of 200ms (reduces lag spikes)
-XX:+DisableExplicitGCPrevents mods from forcing garbage collection
-Dfml.ignoreInvalidMinecraftCertificates=trueFixes some Forge launch errors
+

Arguments to Avoid

+ + + + +
ArgumentWhy to Avoid
-XX:+UseZGCNot available on all JDK/Android combos
-XX:+UseShenandoahGCLimited support on Android
+

Version-Specific Notes

+ +

If you're unsure, leave the arguments at their defaults. Only change them if you're experiencing specific performance or crash issues.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/going_further/MODPACKS.html b/docs/wiki/going_further/MODPACKS.html new file mode 100644 index 0000000000..e9e5ba7a42 --- /dev/null +++ b/docs/wiki/going_further/MODPACKS.html @@ -0,0 +1,177 @@ + + + +Installing Modpacks — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Installing Modpacks

+

Method 1 — Modrinth Modpacks

+
    +
  1. Browse Modrinth Modpacks and download the .mrpack file.
    2. +
  2. In Copper Launcher, go to Mod Installer → Import Modpack.
    3. +
  3. Select the .mrpack file.
    4. +
  4. Wait for Copper Launcher to install all mods and dependencies automatically.
    5. +
+

Method 2 — CurseForge Modpacks

+
    +
  1. Download a CurseForge modpack ZIP.
    2. +
  2. In Copper Launcher, go to Mod Installer → Import Modpack.
    3. +
  3. Select the CurseForge .zip file.
    4. +
+

Some CurseForge modpacks require downloading mods manually due to distribution restrictions. Copper Launcher will notify you if any mods need manual download.

+

Tips for Running Modpacks on Mobile

+ + +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/going_further/MODS.html b/docs/wiki/going_further/MODS.html new file mode 100644 index 0000000000..efcae10160 --- /dev/null +++ b/docs/wiki/going_further/MODS.html @@ -0,0 +1,180 @@ + + + +Installing Mods — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Installing Mods

+

Copper Launcher supports both Forge and Fabric mod loaders out of the box.

+

Step 1 — Install a Mod Loader

+

Forge

+
    +
  1. From the launcher home screen, tap the version selector.
    2. +
  2. Tap Forge at the top of the version list.
    3. +
  3. Select the Minecraft version + Forge version you want.
    4. +
  4. Tap Install and wait for it to complete.
    5. +
+

Fabric

+
    +
  1. Tap the version selector.
    2. +
  2. Tap Fabric.
    3. +
  3. Select your desired Minecraft + Fabric Loader version.
    4. +
  4. Tap Install.
    5. +
+

For Fabric, also install Fabric API — most mods require it.

+

Step 2 — Add Mods

+

Once a mod loader is installed, mods go in the mods folder inside your Minecraft directory.

+

From the launcher, tap Folder icon → Game Directory, then open the mods folder. Download mods from Modrinth or CurseForge, then place the .jar file in the mods folder.

+

Only download mods from trusted sites. Unofficial mods may contain malware.

+

Troubleshooting Mods

+

Game crashes after adding a mod? Make sure the mod is compatible with your Minecraft version and all dependencies are installed. Remove recently added mods one at a time to find the culprit.

+

Mods not showing in-game? Confirm the .jar is in the correct mods folder and you launched the correct Forge/Fabric profile.

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/going_further/OPTIMIZATION.html b/docs/wiki/going_further/OPTIMIZATION.html new file mode 100644 index 0000000000..8e96ea9f7b --- /dev/null +++ b/docs/wiki/going_further/OPTIMIZATION.html @@ -0,0 +1,187 @@ + + + +Optimization — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Optimization Guide

+

Built-In Performance Features

+

Copper Launcher ships with several performance improvements out of the box: Sodium, Krypton Wrapper, MobileGlues, and GL4ES. These are active by default — no extra setup needed.

+

In-Game Video Settings

+ + + + + + + + +
SettingLow-endHigh-end
Render Distance4–6 chunks10–12 chunks
GraphicsFastFancy
Smooth LightingOffMaximum
CloudsOffFancy
ParticlesMinimalAll
Framerate Limit3060 / Unlimited
+

Java Arguments for Performance

+

Add these in Settings → Java Arguments:

+
-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1
+

RAM Allocation

+ + + + + + +
Device RAMRecommended Allocation
3GB1–1.5GB
4GB1.5–2GB
6GB2–3GB
8GB+3–4GB
+

Allocating too much RAM can cause worse performance. More is not always better.

+

Additional Performance Mods

+ + +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/going_further/SHADERS.html b/docs/wiki/going_further/SHADERS.html new file mode 100644 index 0000000000..6b5ed62ec0 --- /dev/null +++ b/docs/wiki/going_further/SHADERS.html @@ -0,0 +1,186 @@ + + + +Shaders — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Shaders

+

Shaders are demanding. Even high-end Android devices may struggle. Start with lightweight shader packs.

+

Compatibility

+ + + + + +
RendererShader Support
GL4ESLimited — some shaders work
MobileGluesBetter compatibility with modern shaders
VirGLVaries
+

Recommended Shader Packs for Mobile

+ +

Installing Shaders (Iris — Fabric)

+
    +
  1. Install Fabric + Iris Shaders.
    2. +
  2. Launch Minecraft.
    3. +
  3. Go to Options → Video Settings → Shader Packs.
    4. +
  4. Open the shader packs folder, copy your .zip file in.
    5. +
  5. Select the shader.
    6. +
+

Performance Tips for Shaders

+ +

If shaders cause crashes, try switching the renderer in Copper Launcher settings (GL4ES → MobileGlues or vice versa).

+ +
+
+ + + + + \ No newline at end of file diff --git a/docs/wiki/index.html b/docs/wiki/index.html new file mode 100644 index 0000000000..f57c44eb3e --- /dev/null +++ b/docs/wiki/index.html @@ -0,0 +1,186 @@ + + + +Wiki — Copper Launcher + + + + + + + + + + + + +
+ + + +
+ +

Wiki

+

Welcome to the Copper Launcher wiki. Find everything you need to install, configure, and get the most out of Copper Launcher.

+

Getting Started

+ +

Going Further

+ +

FAQ

+ +

Community

+ + + + + +
LinkDescription
DiscordChat with the community
GitHubSource code and issue tracker
ModrinthCopper Launcher on Modrinth
+ +
+
+ + + + + \ No newline at end of file