{"id":18980538,"url":"https://github.com/ezzud/minecraftlauncher-template","last_synced_at":"2025-04-19T19:13:25.203Z","repository":{"id":58484608,"uuid":"408511229","full_name":"Ezzud/minecraftlauncher-template","owner":"Ezzud","description":"Template for a Modded/Vanilla Minecraft Launcher (AutoUpdate - Custom Appdata)","archived":false,"fork":false,"pushed_at":"2023-06-06T01:00:32.000Z","size":1408,"stargazers_count":15,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T08:45:48.111Z","etag":null,"topics":["autoupdate","bootstrap","launcher","minecraft","minecraft-forge","minecraft-launcher","minecraft-launcher-core","minecraft-launcher-template","minecraft-server","minecraft-template","minecraftlauncher"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ezzud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"custom":["https://paypal.me/ezzudpro","https://ezzud.fr/discord"]}},"created_at":"2021-09-20T16:05:57.000Z","updated_at":"2025-03-16T13:00:47.000Z","dependencies_parsed_at":"2023-01-17T19:45:18.458Z","dependency_job_id":null,"html_url":"https://github.com/Ezzud/minecraftlauncher-template","commit_stats":null,"previous_names":[],"tags_count":3,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ezzud%2Fminecraftlauncher-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ezzud%2Fminecraftlauncher-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ezzud%2Fminecraftlauncher-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ezzud%2Fminecraftlauncher-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ezzud","download_url":"https://codeload.github.com/Ezzud/minecraftlauncher-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249239333,"owners_count":21235845,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autoupdate","bootstrap","launcher","minecraft","minecraft-forge","minecraft-launcher","minecraft-launcher-core","minecraft-launcher-template","minecraft-server","minecraft-template","minecraftlauncher"],"created_at":"2024-11-08T16:07:03.390Z","updated_at":"2025-04-16T12:31:09.051Z","avatar_url":"https://github.com/Ezzud.png","language":"Java","funding_links":["https://paypal.me/ezzudpro","https://ezzud.fr/discord"],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003e\u003ca href=\"https://github.com/Ezzud/minecraftlauncher-template\"\u003e\u003cimg src=\"https://github.com/Ezzud/minecraftlauncher-template/raw/main/launcher/src/fr/ezzud/defaultlauncher/resources/icon.png\" width=\"34px\" height=\"34px\"/\u003e Ezzud's Minecraft Launcher Template\u003c/h1\u003e\n\n\u003cp\u003e\n- \u003ca href=\"https://github.com/Ezzud/minecraftlauncher-template/tree/main#-requirements\"\u003eRequirements\u003c/a\u003e\u003cbr /\u003e\n- \u003ca href=\"https://github.com/Ezzud/minecraftlauncher-template/tree/main#i-install-the-workspace\"\u003eI Setup Workspace\u003c/a\u003e\u003cbr /\u003e\n- \u003ca href=\"https://github.com/Ezzud/minecraftlauncher-template/tree/main#ii-setup-launcher\"\u003eII Setup Launcher\u003c/a\u003e\u003cbr /\u003e\n- \u003ca href=\"https://github.com/Ezzud/minecraftlauncher-template/tree/main#iii-setup-the-s-update-server\"\u003eIII Setup S-Update\u003c/a\u003e\u003cbr /\u003e\n- \u003ca href=\"https://github.com/Ezzud/minecraftlauncher-template/tree/main#iv-setup-the-bootstrap\"\u003eIV Setup Bootstrap\u003c/a\u003e\u003cbr /\u003e\n- \u003ca href=\"https://github.com/Ezzud/minecraftlauncher-template/tree/main#-for-any-help-join-my-discord-at-httpsezzudfrdiscord\"\u003eSupport\u003c/a\u003e\u003cbr /\u003e\n\u003c/p\u003e\n\n\n\u003ch1\u003eDEMO\u003c/h1\u003e\n\nLauncher Demo:\u003cbr/\u003e\n![image](https://user-images.githubusercontent.com/44119886/188251148-1d898248-5af0-4d96-801d-9c5c328ff515.png)\u003cbr/\u003e\n\nBootstrap Demo:\u003cbr/\u003e\n![image](https://user-images.githubusercontent.com/44119886/188251161-403a879a-3083-4237-b76f-8f8e442f9ca1.png)\u003cbr/\u003e\n\n\n\u003ch1\u003e✨ Features\u003c/h1\u003e\n\n\u003cp\u003e\n\n🎈 CUSTOM APPDATA\u003cbr /\u003e\n🎈 CUSTOM DESIGN\u003cbr /\u003e\n\n⌛ SELF-HOSTED AUTO UPDATE\u003cbr /\u003e\n⌛ SELF-HOSTED LAUNCHER UPDATE\u003cbr /\u003e\n⌛ MICROSOFT AUTH\u003cbr /\u003e\n\n✅ MCP COMPATIBLE\u003cbr /\u003e\n✅ FORGE OR VANILLA COMPATIBLE\u003cbr /\u003e\n✅ **1.7.10 -\u003e 1.13.2** Tested\n\n⭐ EMAIL SAVER\u003cbr /\u003e\n⭐ PASSWORD ENCRYPTED SAVER\u003cbr /\u003e\n⭐ RAM SELECTOR\u003cbr /\u003e\n⭐ EMERGENCY BUTTON\u003cbr /\u003e\n⭐ SHOW/HIDE EMAIL OR PASSWORD FOR STREAMING\u003cbr /\u003e\n⭐ EASY TO CONFIGURE\u003cbr /\u003e\n\n\u003c/p\u003e\n\n\u003ch1\u003e🛑 Requirements\u003c/h1\u003e\n\n\u003cp\u003e\n\n\u003e **FOR LAUNCHER ONLY** [OpenAuth v1.1.2](https://beta.ezzud.fr/download/openauth-1.1.2.jar)\u003cbr /\u003e\n\u003e **FOR LAUNCHER ONLY** [OpenLauncherLib v3.0.5](https://beta.ezzud.fr/download/openlauncherlib-3.0.5.jar)\u003cbr /\u003e\n\u003e **FOR LAUNCHER ONLY** [Fernet v1.5.0](https://beta.ezzud.fr/download/fernet-java8-1.5.0.jar)\u003cbr /\u003e\n\u003e **FOR LAUNCHER ONLY** [Apache Commons Codec v1.15](https://beta.ezzud.fr/download/commons-codec-1.15.jar)\u003cbr /\u003e\n\u003e **FOR BOOTSTRAP ONLY** [OpenLauncherLib v2.1](https://beta.ezzud.fr/download/openlauncherlib-2.1-SNAPSHOT.jar)\u003cbr /\u003e\n\u003e [S-Update v3.1.0](https://beta.ezzud.fr/download/s-update-3.1.0-BETA.jar)\u003cbr /\u003e\n\u003e [Swinger v1.0.0](https://beta.ezzud.fr/download/swinger-1.0.0-BETA.jar)\u003cbr /\u003e\n\n\u003e Any Web Hoster (with php incuded)\u003cbr /\u003e\n\u003e **WEBHOSTER** [S-Update server-side v3.1.0](https://github.com/Litarvan/S-Update-Server/releases/download/3.1.0-BETA/s-update-server-3.1.0.zip)\u003cbr /\u003e\n\n\n\u003c/p\u003e\n\n\u003ch1\u003e📜 Installation\u003c/h1\u003e\n\n\u003ch2\u003eI Install the workspace\u003c/h2\u003e\n\u003cp\u003e\n\n1.0 - Download all requirements from the requirement section \u003cbr /\u003e\n1.1 - Open your Java IDE (Eclipse, IntelliJ)\u003cbr /\u003e\n1.2 - Optional: With Eclipse IDE, open the \".project\" file on launcher \u0026 bootstrap (Easier)\u003cbr /\u003e\n1.3 - Create a JavaProject for Launcher, AND ANOTHER for Bootstrap (⚠ Launcher \u0026 Bootstrap are 2 different projects)\u003cbr /\u003e\n1.4 - Import respective launcher \u0026 bootstrap files into each project\u003cbr /\u003e\n1.5 - Import required Libraries\u003cbr /\u003e\n\n\n\u003c/p\u003e\n\n\u003ch2\u003eII Setup Launcher\u003c/h2\u003e\n\n\u003cp\u003e\n\n2.0 - (IDE) Open the `src/fr.ezzud.defaultlauncher/functions.java` file\u003cbr /\u003e\n2.1 - (IDE) Edit your website url, appdata name, launcher name etc...\u003cbr /\u003e\n2.2 - (IDE) Edit messages as you want\u003cbr /\u003e\n2.3 - (IDE) Replace `https://yourwebsite.com/supdate/` by your website url where the s-update server will be hosted (Example: https://site.com/supdate/)\u003cbr /\u003e\n💡 You can store s-update server in a folder on your website, so add the folder in your URL\u003cbr /\u003e\n2.4 - (MISC) Change textures in `fr.ezzud.defaultlauncher.resources` if you want to edit textures\u003cbr /\u003e\n2.5 - (IDE) Open the `src/fr.ezzud.defaultlauncher/Main.java` file\u003cbr /\u003e\u003cbr /\u003e\n2.6 - (IDE) At line 30, Change your Minecraft Game version:\u003cbr /\u003e\n📢 **FOR 1.7.10**: ![image](https://user-images.githubusercontent.com/44119886/188249478-bf22ceeb-5f90-47e4-9dcc-dc2720e6d366.png)\u003cbr /\u003e\n📢 **FOR 1.8 TO 1.12**: ![image](https://user-images.githubusercontent.com/44119886/188249487-4c8b31fe-f704-43d7-931e-ae2d28b5ad55.png)\u003cbr /\u003e\n📢 **FOR 1.13 TO 1.16**: ![image](https://user-images.githubusercontent.com/44119886/188249508-81200964-2a38-4fa3-8439-e8e4c09de230.png)\u003cbr /\u003e\u003cbr /\u003e\n📢 **IF YOU WANT TO REMOVE FORGE FROM THE LAUNCHER**: \u003cbr /\u003e\n        \u003cp\u003e\n\u003e (IDE) At line 31, Remove `new GameTweak[] { GameTweak.FORGE }` by \"null\"\u003cbr /\u003e\n        ![image](https://user-images.githubusercontent.com/44119886/188250349-318d708c-bda2-4099-8a0d-afac735e8678.png)\u003cbr /\u003e\u003cbr /\u003e\n\u003c/p\u003e\n\n\n2.7 - (IDE) Extract your project as a Executable JAR and name it **launcher.jar** (Name is important)\u003cbr /\u003e\n\n\u003c/p\u003e\n\n\u003ch2\u003eIII Setup the S-Update server\u003c/h2\u003e\n\n\u003cp\u003e\n\n3.0 - (MISC) Download the s-update server zip from the requirement section\u003cbr /\u003e\n3.1 - (FTP) Upload the content of the ZIP file in a folder named **supdate** in your web hoster\u003cbr /\u003e\n3.2 - Wait for upload\u003cbr /\u003e\n3.3 - (WEB) Access to the S-Update panel with `https://your-url.com/supdate`\u003cbr /\u003e\n  ⚠ If you get 404 error, go on `https://your-url.com/supdate/index.php/`\u003cbr /\u003e\n  ⚠ If after registering, you didn't get redirected, verify permission (Debian: `chmod -R 777 /var/www/html/supdate`)\u003cbr /\u003e\n  ⚠ If you cannot setup password, go on \u003ca href=\"https://ezzud.fr/download/server.json\"\u003ethis link\u003c/a\u003e and paste content into `https://your-url.com/supdate/config/server.json`\u003cbr /\u003e\n3.4 - (WEB) Create admin credentials (to reset, delete file **server.json** at update/config/)\u003cbr /\u003e\n3.5 - (WEB) Enable S-Update by clicking on the circle (if it is already green, he is already activated) \u003cbr /\u003e\n3.6 - (MISC) Go on your **Appdata/Roaming/.minecraft/version** folder\u003cbr /\u003e\n3.7 - (MISC) Go on the folder with the name of the version you chosen (NOT FORGE)\u003cbr /\u003e\n3.8 - (MISC) Take the yourversion.jar file, copy and rename it by `minecraft.jar`\u003cbr /\u003e\n3.9- (FTP) Go back to your WebHoster FTP\u003cbr /\u003e\n3.10 - (FTP) Access to the `files` folder (or create it)\u003cbr /\u003e\n3.11 - (FTP) Select all these files:\u003cbr\u003e\n  - `minecraft.jar` that you got before\n  - `assets` folder from your .minecraft appdata folder\n  - `libraries` folder from your .minecraft appdata folder (💡TIP: On Windows, go to \"libraries\" folder and type in search bar \"*.jar\", then press CTRL+A to select all libraries)\n  - `bin` folder from your .minecraft appdata folder (💡TIP: On Windows, go to \"bin\" folder and type in search bar \"*.jar\", then press CTRL+A to select all libraries)\n\n\n⚠ **I recommend you to launch Minecraft in your desired version in another appdata folder to get ONLY the assets, libraries \u0026 natives for the version you want**\u003cbr /\u003e\n⚠ **YOU NEED TO RENAME \"libraries\" FOLDER TO \"libs\"**\u003cbr /\u003e\n⚠ **YOU NEED TO RENAME \"bin\" FOLDER TO \"natives\"**\u003cbr /\u003e\n⚠ **If you don't have \"bin\" folder**, try to delete the bin folder and launch your Minecraft with the correct forge version\u003cbr /\u003e\nAlso you can download 1.12.2 Minecraft natives \u003ca href=\"https://ezzud.fr/download/1.12.2-natives.zip\"\u003ehere\u003c/a\u003e\u003cbr /\u003e\u003cbr /\u003e\n  \n3.12 - (FTP) Place all selected files into the **files** folder in the S-UPDATE\n\n3.13 - (FTP) Add other folders like \"mods\" folder or anything your launcher need (mods folder, config folder, every folder that is normally on .minecraft folder\u003cbr /\u003e\n3.14 - (FTP) Open the `supdate/config/ignore.list` file and add every folder and file you want not to be **deleted/replaced by original version** during launcher updates\u003cbr /\u003e\n💡 Recommended list:\u003cbr\u003e\n  ```\n  options.txt\n  saves/\n  resourcepacks/\n  resources/\n  shaderpacks/\n  logs/\n  crash-reports/\n  screenshots/\n  launcher.properties\n  ram.txt\n  launcher/\n  game/\n  journeymap/\n  ```\n3.15 - (FTP) Every time you change the `files` folder in your FTP, when launcher starts it will update the new files \u0026 folders\u003cbr /\u003e\n3.16 - (FTP) Save the file and now your launcher will work when you launch `launcher.jar`\u003cbr /\u003e\n\n\u003ch4\u003e🎤 If you don't want to add a launcher updater, you are free to stop reading because the next part will talk about setting-up the bootstrap\u003c/h4\u003e\n\n\u003c/p\u003e\n\n\n\u003ch2\u003eIV Setup the Bootstrap\u003c/h2\u003e\n\n\u003cp\u003e\n\n4.0 - (IDE) Open or Import **bootstrap** project in your Java IDE \u003cbr /\u003e\n4.1 - (IDE) Open the `src/fr.ezzud.defaultbootstrap/functions.java` file\u003cbr /\u003e\n4.2 - (IDE) Edit the file with your informations\u003cbr /\u003e\n4.3 - (IDE) Replace supdate URL by your supdate url with **/bootstrap** after the url\u003cbr /\u003e(Example: https://yourwebsite.com/supdate/bootstrap/)\u003cbr\u003e\n  ⚠ If you get 404 error, go on `https://example.com/supdate/bootstrap/index.php/`\u003cbr /\u003e\n  ⚠ If after registering, you didn't get redirected, verify permission (Debian: `chmod -R 777 /var/www/html/supdate`)\u003cbr /\u003e\n  ⚠ If you cannot setup password, go on \u003ca href=\"https://ezzud.fr/download/server.json\"\u003ethis link\u003c/a\u003e and paste content into `https://your-url.com/supdate/bootstrap/config/server.json`\u003cbr /\u003e\n4.4 - (IDE) Extract the project as a JAR Executable and name it `bootstrap.jar` (not important)\u003cbr /\u003e\n\n4.5 - (FTP) **In the S-Update folder**, create a new folder named `bootstrap`\u003cbr /\u003e\n4.6 - (FTP) Duplicate __the entire__ supdate folder ⚠ except **bootstrap** folder and **files** folder\u003cbr /\u003e\n4.7 - (FTP) In the freshly created bootstrap folder, create a `files` folder\u003cbr /\u003e\n4.8 - (FTP) Upload your launcher.jar (the JAR of the launcher from the Part 2)\u003cbr /\u003e\n4.9 - (FTP) Create a `Libs` folder (with the cap) and upload all libraries used in the `launcher project`\u003cbr /\u003e\n4.10 - Now when you start `bootstrap.jar` it will check if launcher is updated and if so the launcher will start\u003cbr /\u003e\n\n\u003c/p\u003e\n\n\u003ch1\u003e❓ For any help, join my discord at https://ezzud.fr/discord\u003c/h1\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezzud%2Fminecraftlauncher-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fezzud%2Fminecraftlauncher-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezzud%2Fminecraftlauncher-template/lists"}