# Kimetsunoyaiba Tweaks (Forge)
#### aka *The Forgotten Necessities* update
A comprehensive Forge mod that enhances the [Kimetsu no Yaiba mod](https://www.curseforge.com/minecraft/mc-mods/kimetsunoyaiba) with multiplayer features, visual effects, and gameplay enhancements.
Please check my [wiki](https://github.com/YeeticusFinch/KimetsunoyaibaTweaks/wiki) for more information.
Join us on [Discord](https://discord.gg/W8K962vQFT)
---
## Frequently Asked Questions
### Help I have the item stacking glitch
- There is a glitch where if you hold an item then suddenly new items of that same type will no longer be able to stack on that item
- "_if i tried picking up 4 blocks of wood one would just go into another corner while the other 3 were in a stack_"
- **FIX: update to version 1.6.443 or higher**
### Where did the the custom swords go?
- The new swords (like ice and frost) are now in KnY Extra Additions
- curseforge.com/minecraft/mc-mods/kny-extra-additions
- https://modrinth.com/mod/kny-extra-additions
- https://github.com/YeeticusFinch/KnY-Extra-Additions/
### My world creation is stuck at 100%
- UPDATE: Region files for Mt Fujikasane and Swordsmith Village are now in this mod:
- [https://modrinth.com/mod/kny-worlds](https://modrinth.com/mod/kny-worlds)
- This means that Mt Fujikasane isn't importing properly
- Try upgrading to the latest version of Kimetsunoyaiba Tweaks
- Otherwise, you can fix it manually:
- Go to your .minecraft folder --> kimetsunoyaibamultiplayer --> mt_fujikasane_cache
- If this folder is empty, then you've got a problem
- https://github.com/YeeticusFinch/KimetsunoyaibaTweaks/tree/main/region
- ^^ Download all the region files from this GitHub link
- Place all those .mca files into minecraft/kimetsunoyaibamultiplayer/mt_fujikasane_cache/
- Reload the mod and try again
### Where can I get help with this mod?
- I don't usually check comments on the mod page
- If you need support, please join on discord: https://discord.gg/W8K962vQFT
- Or send an email to
[email protected]
### The game crashes on mod loading
- Make sure you have forge 47.4.0
- Make sure you have the forge versions for 1.20.1 for all the following dependency mods
- Kimetsunoyaiba
- Mob Player Animator
- Player Animator
- GeckoLib
- KnY Worlds
- Make sure you don't have Optifine, it's completely incompatible
### My spawns are messed up, there are no Hashira or Kizuki demons or named characters spawning?
- Go into the config for Kimetsunoyaiba Tweaks (aka Kimetsunoyaiba Multiplayer)
- Disable enhanced spawning
- Enhanced Spawning will prevent named characters, hashira, and kizuki demons from spawning - outside of raids and quests and special biomes/structures
### How do I configure this mod?
- I recommend using a config mod, like Configured or Forge Config Menus
- Alternatively, you can go into your minecraft folder --> config --> Kimetsunoyaiba Multiplayer
- You can edit the .toml files directly
### Missing textures
- Yes sorry I haven't finished making all the assets yet
---
## ✨ Features
### 🎭 Animation Synchronization
- **Multiplayer Animation Support**: Makes PlayerAnimator animations visible to all players in multiplayer
- Detects when a player starts/stops an animation
- Sends animation data (player, animation name, looping flag) to the server
- Server rebroadcasts animations to all nearby clients
- Uses MobPlayerAnimator to display animations on other players
- Works in both **LAN** and **dedicated servers**
### ⚔️ Sword Display System
- **Visual Sword Display**: Nichirin swords are displayed on your character when not being held
- Automatically places swords on your hip or back when stored in inventory
- Supports up to 2 swords displayed simultaneously (left and right positions)
- Swords disappear from display when equipped or removed from inventory
- **Fully Configurable**:
- Choose between hip or back placement
- Adjust position, rotation, and scale for each sword independently
- Separate configurations for left/right and hip/back positions
- Config location: `config/kimetsunoyaibamultiplayer/sword_display.toml`
### ✨ Particle Effects
- **Sword Swing Particles**: Configurable particle effects when swinging nichirin swords
- Particle mapping system for different sword types
- Trigger modes: Animation-based or attack-based
- Customizable colors, sizes, and particle types
- Config location: `config/kimetsunoyaibamultiplayer/particles.toml`
### 🦅 Enhanced Crow System
- **Quest Markers**: Crows display markers when carrying quest information
- **Custom Models**: GeckoLib-based 3D crow models
- **Animation Support**: Flying animations for kasugai crows
- **Waypoint Navigation**: Crows fly to quest locations
- Config location: `config/kimetsunoyaibamultiplayer/entities.toml`
### 🔫 Gun Animation Support
- Dynamic gun animations for rifle and other firearms
- Automatic detection and animation playback
- Compatible with Kimetsu no Yaiba firearms
---
## 🛠 Requirements
- **Minecraft Forge** `1.20.x` (other versions may work but are untested).
- **PlayerAnimator** mod (installed on both client and server).
- **MobPlayerAnimator** mod (installed on both client and server).
- Other mods that use PlayerAnimator (e.g. Kimetsu no Yaiba).
---
## 📦 Installation
1. Download the latest release of:
- `PlayerAnimator`
- `MobPlayerAnimator`
- `KimetsunoyaibaMultiplayer (this mod)`
2. Place both `.jar` files in your `mods/` folder (client and server).
3. Launch Minecraft with Forge.
---
## 🎮 Commands
The mod includes several test and debug commands:
- `/testanim` - (Server) Plays test animation on all connected players
- `/testanimc` - (Client) Tests client-side animation and syncing
- `/testparticles` - Tests sword particle effects
- `/debugparticles` - Displays particle configuration debug info
- `/testanim ` - Plays a specific animation
- `/testcrowquest` - Tests crow quest marker system
- `/debugcrow` - Shows debug information for nearby crows
- `/testcrowrender` - Spawns marker entities at crow positions to debug visibility
All commands require operator permission level 2.
---
# Credits
[yuichiro354](https://www.curseforge.com/members/yuirchiro354/) \- ideas, community management, talent acquisition, and some textures
[Gop6939](https://www.curseforge.com/members/Gop_006/) - ideas, community management, models and textures, Portuguese (PT) translator
[ghumio](https://www.curseforge.com/members/ghumio/projects) - models and textures
[GalaxyProductions](https://www.youtube.com/@GalaxyProductions.Official) - ideas, lots of models and textures (armor, weapons, and entities)
[Plasmatier](https://www.youtube.com/@HYPERPLASMATIER) - ideas, concept artist, textures, "makes the pixels pretty"
[Headset Hero](https://youtube.com/@headsethero80?si=gyEwMD8wdYOjy1Up) - wisteria biome and textures (blocks and potions)
[stxrwvbs](https://www.curseforge.com/members/stxrwvbs/) - ideas, concept artist, asset creation
[BoutiqueDivine](http://curseforge.com/members/boutiquedivine/) - concept artist, models and textures
[Luchar Olimur](https://www.tumblr.com/little-virus-sasha?source=share) - Portuguese (BR) translator
[asphodelian architect](https://www.planetminecraft.com/member/asphodelian_architect/) - Builder