Skip to content

Latest commit

 

History

History
137 lines (102 loc) · 6.39 KB

README.md

File metadata and controls

137 lines (102 loc) · 6.39 KB

Kyoyu

License Modrinth Discord

GitHub Workflow GitHub Issues GitHub Created At

共有 -> Kyōyū [kʲo̞ːjɯ̟ː]
≒ Sharing

This mod shares .litematic files with other players.
Litematica support. Inspired by Syncmatica.

This project is still a work in progress, so feel free to send your feature requests or report any issues on GitHub!
Just keep in mind that not everything may be implemented 😄

Do not report Kyoyu issues to Syncmatica!

2025-01-08.00-21-41.mp4

Usage (WIP)

Client Side

  1. Install Fabric or (Forge)[1] to the instance.
  2. Add the Kyoyu Mod and its dependency mods to the Mods folder.
  3. ! This process will no longer be necessary in future updates !
    Create a kyoyu folder in the schematic folder. (~/[instance]/schematic/kyoyu)
  4. Launch!

[1]: 1.16.5 Only

It is possible to join a server without Kyoyu installed using a client with Kyoyu, but you will not be able to use Kyoyu's features!

Server Side

  1. Install Fabric, Forge, NeoForge, or Paper to the server.
  2. Add the Kyoyu Mod and its dependency mods to the Mods folder.
  3. ! This process will no longer be necessary in future updates !
    Create a kyoyu folder in the server folder and create a files folder in the kyoyu folder. (~/[server]/kyoyu/files)
  4. Start the server!

It is possible to join a server with Kyoyu installed using a Vanilla client or an instance without Kyoyu, but you will not be able to use Kyoyu's features!

Dependencies

Loader Client Server
Fabric Malilib, Litematica, Fabric API Fabric API
Forge Malilib, Litematica

Versions

Version Client ｜ Server
Fabric Forge ｜ Fabric Forge NeoForge Paper
1.14 - 1.14.4 ✅ 🚫 ｜ ✅ ✅ 🚫 🚫
1.15 - 1.15.2 ✅ 🚫 ｜ ✅ ✅ 🚫 🚫
1.16 - 1.16.5 ✅ ✅[2] ｜ ✅ ✅ 🚫 🚫
1.17 - 1.17.1 ✅ 🚫 ｜ ✅ ✅ 🚫 🚫
1.18 - 1.18.2 ✅ 🚫 ｜ ✅ ✅ 🚫 🚫
1.19 - 1.19.4 ✅ 🚫 ｜ ✅ ✅ 🚫 ⚠️[3]
1.20 - 1.20.4 ✅ 🚫 ｜ ✅ ✅ 🚫 ⚠️[3]
1.20.5 - 1.20.6 ✅ 🚫 ｜ ✅ ✅ ✅ ⚠️[3]
1.21 - 1.21.3 ✅ 🚫 ｜ ✅ ✅ ✅ ⚠️[3]
1.21.4 ✅ 🚫 ｜ ✅ ✅ ✅ 🚫
Fabric Forge Fabric Forge NeoForge Paper

[2]: This is only compatible with builds published by Litematica
[3]: It launches, but cannot share the schematic.

Features (WIP)

　

  • Error Handling
  • Code Format and Review
  • Client only depend (malilib, litematica)
  • legacy litematica support?
  • Forgematica support?
  • Plugin support?

Network

  • Handshake Packet
  • FileRequest Packet
  • FileResponce Packet
  • LoadExplorer Packet
  • PlacementMeta Packet
  • RemovePlacement Packet

Client

  • Kyoyu button on placements menu
  • Kyoyu in-memory placement
  • Server Kyoyu placements explorer
    • Download
    • Load
    • Material List
    • Remove
  • Modify
  • Unload
  • Relogin compatibility
  • on Placement Update Event

Server

  • Save KyoyuPlacementMeta
  • Restore KyoyuPlacementMeta

Data Types

  • Pos
  • Mirror
  • Rotation
  • Ignore Entities
  • Placement ON/OFF
  • Subregion
    • Pos
    • Mirror
    • Rotation
    • Ignore Entities
    • Placement ON/OFF

Thanks

Inspirations 🔖
⛓️ Syncmatica by nnnik, kpzip, and sakura-ryoko

Uses ⭐
🪨 Stonecutter by kikugie
🍤 Unitemplate by topi

Last README Update 2025/1/11 12:57 UTC+9