{"id":14969625,"url":"https://github.com/tetratau/toki","last_synced_at":"2025-10-24T07:30:15.922Z","repository":{"id":111484821,"uuid":"570228149","full_name":"TetraTau/Toki","owner":"TetraTau","description":"A Paper fork providing a Fabric-based modding platform.","archived":false,"fork":false,"pushed_at":"2023-05-15T14:37:03.000Z","size":595,"stargazers_count":47,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-10T03:41:31.033Z","etag":null,"topics":["bukkit","craftbukkit","fabric","fabric-loader","fabricmc","java","minecraft","minecraft-api","minecraft-server","modding","paper","paper-fork","papermc"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TetraTau.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-24T16:28:22.000Z","updated_at":"2024-06-11T16:48:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"c0272751-3c32-45d2-821a-5a3834c10f68","html_url":"https://github.com/TetraTau/Toki","commit_stats":{"total_commits":25,"total_committers":2,"mean_commits":12.5,"dds":0.36,"last_synced_commit":"d5f6f6f361105e606375d060ef3b16b874bc8c84"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TetraTau%2FToki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TetraTau%2FToki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TetraTau%2FToki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TetraTau%2FToki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TetraTau","download_url":"https://codeload.github.com/TetraTau/Toki/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219866292,"owners_count":16555826,"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":["bukkit","craftbukkit","fabric","fabric-loader","fabricmc","java","minecraft","minecraft-api","minecraft-server","modding","paper","paper-fork","papermc"],"created_at":"2024-09-24T13:42:08.156Z","updated_at":"2025-10-24T07:30:15.233Z","avatar_url":"https://github.com/TetraTau.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"toki_logo.png\" align=\"right\" width=\"150\" height=\"150\"/\u003e\n\n# Toki\n\nToki is a server-side modding platform which makes it possible to create and port [Fabric](https://github.com/FabricMC/fabric) mods on the [Paper](https://github.com/PaperMC/Paper) server software and its forks.\n\nSee the [Toki example mod](https://github.com/TetraTau/toki-example-mod/tree/master) as a reference.\n\n### !WARNING!\n1. The project doesn't let you run already existing [Fabric](https://github.com/FabricMC/fabric) mods, instead it aims to provide developers an easy tool for porting those mods for [Paper](https://github.com/PaperMC/Paper) and its forks.\n2. The project is highly WIP, expect bugs and limitation in the toolchain, please create issues for bug reports and feature requests.\n\n### Join [discord](https://discord.gg/upTtNyvkNf) for discussion\n\n## Download\nFor now you can download builds only from our [Github releases](https://github.com/TetraTau/Toki/releases)\n\n## Infrastructure\n### [Tokimak](https://github.com/TetraTau/tokimak)\nThis is a Gradle plugin which provides Paper source code and Loom's features like Mixin remapping.\nFor now it is WIP, but it is suitable for basic Mixin development using Mojang mappings.\n\n### [Toki installer](https://github.com/TetraTau/toki-installer)\nThis is an application and library which lets you install Toki on forks of Paper. \\\nIt is also used in the Toki's buildscript for building purposes.\n\n## Motivation and goals\nThis project exists to solve two problems: *Hybrid server software problem* and *Plugin API limitation problem*.\n\n### Hybrid server software problem\nServer admins often want to have modded servers which 1) support bukkit plugins 2) have good performance.\n\nThe issue with hybrid server software is stability and support, almost none of mods or plugins provide an official support for hybrid server software, so for now the sanest solution is to use the vanilla server software with mods which 1) replace plugins 2) optimize the server.\n\nThe main issue there is optimization mods, which usually don't do invasive changes for the sake of performance. \nOn the other hand, Paper does such changes using its patch system and performs better than almost all of the server optimization modpacks,\nso the solution this project provides is providing an easy to use toolchain and APIs for making / porting fabric mods to it.\n\n### Plugin API limitiation problem\nUsually plugins can't modify Minecraft server internals, and if they do, they do it badly.\nPlugins don't have an official support of modding tools like Mixins and Access wideners,\non one hand it makes plugins more compatible with each other, on the other hand it limits plugin possibilites.\n\nSo if you're a plugin developer willing to do more than usual plugins are capable of, you can use this platform, make mods and run them on Paper or any other Paper fork.\n\n## TODOs / Plans\n- [x] Implement Fabric Loader on top of Paper.\n- [x] Create a Gradle plugin for developers to be able to develop mods with this project.\n- [ ] Create a Toki API mod which has a compatibility with the Fabric API on the client side. (Registry sync)\n- [ ] Make Bukkit API flexible enough to handle modded content.\n\n## Contributing and Technical documentation\nSee [this file](https://github.com/TetraTau/Toki/blob/master/TECH_DOCS_AND_CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftetratau%2Ftoki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftetratau%2Ftoki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftetratau%2Ftoki/lists"}