Katana — a katana for Mycopunk

Русская версия — ниже, в разделе «Катана для Mycopunk».

A new melee primary weapon: a katana with its own model, animations, upgrades and cosmetics. All texts are in English and Russian and follow the game's language automatically. Tested with Mycopunk 2.0.3 and BepInExPack_Mycopunk 5.4.2403.

Controls

• LMB — a three-strike combo; the third strike is a heavy finisher (×1.9 damage, knockback).
• RMB — a dash slash through everyone in your path. Every katana kill shortens the dash cooldown.
• In the air, looking down, LMB — a plunging strike that hits an area (no fall damage).
• T (inspect) — blade inspection animation.
• F7 — in-game panel to adjust how the katana is held.

What's in the mod

• A katana model in the game's style, two-handed grip in first person, swings in third person for other players.
• 45 upgrades on the grid: element edges (fire, shock, acid, cryo, decay), Iaido, Kaeshi, Blade Rhythm, Slash Wave, Thousand Cuts (Judgment Cut), Muramasa Blade (regeneration on kills), Raijin, Issen, Deflect (a parry stance instead of the dash) and more. Grid, drops, scrapping and boosts work like on vanilla weapons.
• Levels up to 30 with rewards, like vanilla weapons.
• Cosmetics (32): 8 skins, 8 crabs, 8 flairs (slash colour and effects), 8 inspect motions.
• The vanilla Ouroboros grid stealer (Contraband) and the Oddity grid grower work on the katana too.
• Katana sounds have a limited range (20 m by default).

Installation

With r2modman / Gale / Thunderstore Mod Manager (recommended): find Katana in the Online tab and install it — BepInExPack_Mycopunk is installed automatically. Launch the game with Start modded.

Manually:

1. Install BepInExPack_Mycopunk into the game folder and run the game once.
2. Put Katana.dll from the archive into Mycopunk\BepInEx\plugins\.

Unlocking and progression

The katana is earned like a vanilla primary weapon:

• It appears locked in the primary weapon list. Unlock it there by holding Unlock and paying the same price as the vanilla gun-token weapons — 1 gun token (the mod copies this from the game's own primaries at startup). Gun tokens come from player levels 3–8; if you already spent all of them, the game itself tops you up with the token the katana needs. The katana can also be offered in the free "choose a weapon" pick after your first mission.
• It starts at level 1 with no upgrades. Katana XP comes from kills with it; levels 2–30 give rewards (upgrades, boosted upgrades, cosmetics).
• Upgrades drop like vanilla ones once the katana is unlocked (enemies, crates, mission rewards, level rewards).
• Cosmetics come from the vanilla sources: skin drops next to katana upgrades, katana level rewards.

Updating from 2.1.0: 2.1.0 was a test build that gave the katana and all its upgrades/cosmetics for free. Nothing is taken away — whatever your save already has stays. The old test switches in your config are turned off once.

Testers: [Debug] UnlockEverything = true restores the 2.1.0 setup (katana unlocked without a token, every upgrade and cosmetic granted). [Upgrades] GrantAll / GrantAllCosmetics grant only upgrades / only cosmetics.

Multiplayer

• Every player in the lobby needs the mod, ideally the same version.
• The mod lets players with mods join on the host's side ([Multiplayer] AllowModdedJoin).
• Other players see your katana, swings, waves, plunging strike and parry stance.

Settings

File BepInEx\config\katana.mycopunk.melee.cfg (in r2modman — Config editor). Useful options:

• [General] TextLanguage — language of all mod texts: auto (default: Russian game → Russian, any other language → English) / en / ru.
• [Cosmetics] EffectsLevel — full / reduced / minimal: how many effects skins, flairs and crabs show.
• [Feel] SoundDistance — range of katana sounds (m).
• [Feel] CustomSounds — experimental custom katana sounds.

Troubleshooting

1. Set [General] VerboseLogging = true and reproduce the problem.
2. Send the author BepInEx\LogOutput.log (the mod's lines start with [Katana]).
3. For a full check of the mod, enable [Debug] SelfTest = true — after you enter the game, BepInEx\config\katana_selftest.txt appears.

Limitations

• The mod is built on top of a vanilla weapon; after big Mycopunk updates it may stop working until a new version is released.
• Players without the mod can't play in the same lobby as a player who has it.

Uninstalling

Before uninstalling, equip a standard primary weapon. Then remove the mod in your manager or delete BepInEx\plugins\Katana.dll.

Катана для Mycopunk

Новое основное оружие ближнего боя: катана с собственной моделью, анимациями, улучшениями и косметикой. Все тексты — на русском и английском, язык выбирается автоматически по языку игры. Проверено на Mycopunk 2.0.3 и BepInExPack_Mycopunk 5.4.2403.

Управление

• ЛКМ — серия из трёх ударов, третий — тяжёлый финишер (урон ×1,9, отбрасывание).
• ПКМ — рывок-разрез сквозь всех на пути. Каждое убийство катаной сокращает перезарядку рывка.
• В прыжке, глядя вниз, ЛКМ — нисходящий удар по площади (без урона от падения).
• T (осмотр) — анимация осмотра клинка.
• F7 — панель настройки положения катаны прямо в игре.

Что есть в моде

• Своя модель катаны в стиле игры, хват двумя руками от первого лица, удары от третьего лица для других игроков.
• 45 улучшений в сетке: кромки стихий (огонь, ток, кислота, лёд, распад), Иайдо, Каэси, Ритм клинка, Волна разреза, Тысяча порезов («Суд клинка»), Клинок Мурамасы (реген за убийства), Райдзин, Иссэн, Отражение (стойка парирования вместо рывка) и другие. Сетка, выпадение, разбор и бусты — как у ванильного оружия.
• Уровни до 30 с наградами, как у ванильного оружия.
• Косметика (32 шт.): 8 обликов, 8 крабиков, 8 искр (цвет удара и эффекты), 8 анимаций осмотра.
• Для катаны работают «Мультивселенский грабёж» и «Нарушение границ».
• Звуки катаны ограничены дальностью (по умолчанию 20 м).

Установка

Через r2modman / Gale / Thunderstore Mod Manager (рекомендуется): найдите мод Katana во вкладке Online и установите — BepInExPack_Mycopunk поставится сам. Запускайте игру кнопкой Start modded.

Вручную:

1. Установите BepInExPack_Mycopunk в папку игры и один раз запустите игру.
2. Положите Katana.dll из архива в Mycopunk\BepInEx\plugins\.

Открытие и прокачка

Катана открывается и качается как ванильное основное оружие:

• В списке основного оружия она закрыта. Откройте её там, удерживая «Открыть», за ту же цену, что и ванильное оружие за жетоны, — 1 оружейный жетон (gun token; мод берёт цену у ванильных пушек при запуске). Жетоны дают уровни игрока 3–8; если все уже потрачены, игра сама выдаст недостающий жетон для катаны. Катана также может выпасть в бесплатном выборе оружия после первой миссии.
• Начинает с 1 уровня без улучшений. Опыт — за убийства катаной; уровни 2–30 дают награды (улучшения, усиленные улучшения, косметику).
• Улучшения выпадают как ванильные, когда катана открыта (враги, ящики, награды миссий и уровней).
• Косметика — из ванильных источников: облики, выпадающие рядом с улучшениями катаны, и награды за уровни.

Обновление с 2.1.0: 2.1.0 была тестовой сборкой, где катана, все улучшения и косметика выдавались сразу. Ничего не отбирается — всё, что уже есть в сохранении, остаётся. Старые тестовые переключатели в конфиге выключаются один раз.

Для тестеров: [Debug] UnlockEverything = true возвращает режим 2.1.0 (катана открыта без жетона, выданы все улучшения и косметика). [Upgrades] GrantAll / GrantAllCosmetics выдают только улучшения / только косметику.

Мультиплеер

• Мод должен стоять у всех игроков в лобби, лучше одной версии.
• Мод сам разрешает вход игрокам с модами на стороне хоста ([Multiplayer] AllowModdedJoin).
• Другие игроки видят вашу катану, удары, волны, нисходящий удар и стойку парирования.

Настройки

Файл BepInEx\config\katana.mycopunk.melee.cfg (в r2modman — Config editor). Полезное:

• [General] TextLanguage — язык всех текстов мода: auto (по умолчанию: русская игра → русский, любой другой язык → английский) / en / ru.
• [Cosmetics] EffectsLevel — full / reduced / minimal: сколько эффектов от скинов, искр и крабиков.
• [Feel] SoundDistance — дальность звуков катаны (м).
• [Feel] CustomSounds — экспериментальные собственные звуки катаны.

Если что-то не работает

1. Поставьте [General] VerboseLogging = true и повторите проблему.
2. Пришлите автору файл BepInEx\LogOutput.log (строки мода начинаются с [Katana]).
3. Для полной проверки мода включите [Debug] SelfTest = true — после входа в игру появится BepInEx\config\katana_selftest.txt.

Ограничения

• Мод основан на одном из ванильных видов оружия; после крупных обновлений Mycopunk он может временно перестать работать до выхода новой версии.
• Игроки без мода не могут играть в одном лобби с игроком, у которого стоит мод.

Удаление

Перед удалением выберите в снаряжении стандартное основное оружие. Затем удалите мод в менеджере или файл BepInEx\plugins\Katana.dll.