Symbiote Tweaks (EN)

An unofficial addon for Symbiote: A Bonding Experience by kitigawa. Not made by him, not endorsed by him, and not affiliated with him.

Symbiote is required. Without it this mod does nothing.

No files, assets or code from Symbiote are included in this download — everything in this jar was written for this project. What it does is bind to Symbiote's internals. Those aren't a published API, and neither are mine, so there is no stable seam between the two: a Symbiote update is the most likely reason for this addon to break.

Report bugs here, not on the Symbiote page. If something breaks with both installed, open an issue on this project. Please don't take addon problems to kitigawa — he didn't write this and can't fix it.

Symbiote: A Bonding Experience, by kitigawa — [link]

What is mine and what is not

Everything in this jar is code I wrote. No file, asset or line from Symbiote is included in the download.

Mine: the wall crawl and the ceiling hang, including the ceiling box, the hitbox and suffocation handling, the camera and the pose bridge. The gallows, the feast, the second grab, the door and wall rip, the reach-a-chest, the disarm and the pickpocket. The detached blob, its control and the scene that puts you back in your body. The weakness items, the void offering and the Regrowth Core chain. The stand-down. The Knull, the necrosword and the infected NPCs. Every config option, command and keybind.

Symbiote's, used at runtime and never shipped here: the symbiote itself and everything that makes it what it is — the strains, bond, trust, stress, hunger, stamina and the living armour. Several features here read that state to decide whether they may run at all. Several also draw with Symbiote's own tendril effect and play its sounds, which means those come out of kitigawa's jar on your machine, not out of mine. A couple of buttons are placed inside Symbiote's status screen, next to its own; the buttons are my code sitting on his screen.

Optional third parties: Palladium and KubeJS for the ceiling pose, PixelGore for one scene, Locks Reforged and Cuffed for what their own section describes. All of them are optional and the mod runs without any of them.

Short version: the mechanics are mine, the symbiote is his, and the two only meet while both mods are installed.

You climb, and you hang

I wanted a symbiote that treats a wall as ground. Switch the crawl on and a wall becomes something you go up. Look up hard at an overhang and the tendrils take the ceiling instead — you cross the underside of it with the camera pulled back and dropped low enough that you can actually see yourself up there, instead of staring into the block you are hanging from. Pressing jump throws you off the surface, and sneaking or touching the ground lets go.

The hitbox shrinks while you hang, so the game stops trying to suffocate you in the ceiling, and the pose follows: your body flipped under the block with your arms reaching, drawn through Palladium's animation registry. That pose is the one part that needs company — Palladium and a KubeJS client script that ships beside the mod, because KubeJS only loads scripts from your instance's own folder and a jar cannot hand it one. Without them the crawl still moves you, holds you and gives you the camera; your body just is not flipped while it does.

Things on your own keys

I like abilities I can press, so most of what is here lives on a key rather than in a menu.

The gallows strings up everything around you and drops what they were carrying straight into your inventory. The feast drags the crowd in, eats it, and gives back only the health you were missing — not a point more, because a heal that overshoots turns every fight into a non-event. There is a tendril jump, a second grab that slams two enemies into each other, a door torn off its hinges, a 3x3 piece of wall pulled out whole, a chest opened from across the room, a weapon taken out of a mob's hands, and a pocket picked without the player noticing.

Every one of them is a keybind you own, and every one is built with a modifier slot, so any of them can be rebound to a plain key or to a different Alt, Ctrl or Shift combination without fighting the rest of your pack.

Sending a piece of yourself out

A part of the symbiote detaches and walks on its own while your body stays where it is. You steer it with your ordinary movement keys, and what you see is the tendril tip with the cord still running back to your chest — it never breaks off from you.

It only feels sound and fire, and only while you still have those weaknesses yourself. Everything else — swords, arrows, falls, explosions, poison — passes through it, because a scouting limb that dies to an arrow is a scouting limb nobody uses.

It can take a body, and coming back out of one is a scene rather than a teleport: two tendrils grab the host from either side and tear it open, and you step out of the middle. With PixelGore installed the halves are its own; without it the body simply stops existing and the rest plays the same.

Weaknesses that cut both ways

A bonded host takes more from sonic damage and from fire, and I wanted a way to buy that off permanently rather than carry a counter-item forever.

The Sound Muffler takes the symbiote's hearing — bells stop stunning it, and the Warden's cry stops carrying bonus damage and stress. The Heat Damper takes its fear of fire. Both are built from a Void Piece, which the void hands back in exchange for an offering, and both are consumed on use.

Neither is a trinket, deliberately. A weakness you can put back on by taking an accessory off was not removed, it was parked.

The Regrowth Core

A four step chain, and the fiction is Deadpool's: the cancer is what kills him and the regeneration is what saves him, and it is the fight between the two that brings him back whole. So the path goes through the cancer before the cure, not after.

A long Weakness potion and a Poison II make a Potion of Cancer. An enchanted golden apple and a Regeneration II make Super Regeneration. Those two together make Super Cancer, and Super Cancer with a Void Piece makes the Core. The potions are matched by NBT, so the recipe wants the exact bottle — long weakness, poison II, regeneration II — and not just anything of that type.

It stands down when you say so

This one is for roleplay. I wanted to play a host who has learned to command what he carries, rather than one who lives with it, and that story needs a moment where the symbiote holds still because you said so.

One key, no trust check, no negotiation and no timer — it holds until you hand control back. While it stands down the symbiote stops acting on its own. The exception is yours to make, because asking for Protect Me or Hunt in its own radial menu is telling it to act.

If the story you want is the other one — the symbiote with a will of its own, and the tension that comes with it — that is what Symbiote already gives you, and you get it by playing without this addon.

The Knull

A separate variant, layered over whatever strain the host already had, and limited to one player per world. It is claimed with a command and taken away with the same one, so a server owner is never stuck with it. I wanted a version of the fantasy where the host is the top of the food chain, and a world where only one player can be.

The Knull hits harder and takes less, its stamina and living armour are held full, and its status screen carries its own identity. All of the numbers are in the config, including the ones the screen shows.

The necrosword. Drawn on its own key. Right click does not swing it — it fires a bolt that deals no damage at all and marks whatever it touches. After a short delay the mark opens: tendrils erupt from the marked target, drag every mob around it inward, and the whole thing implodes. The bolt deals nothing on purpose, so nothing dies before the ability has a chance to happen.

Infected NPCs. Sneak and right click a named mob with the necrosword in hand and the symbiote takes it. Only the Knull can do this, and only on a mob that has a name — a nameless villager is population, a named one is somebody, and the name is also what keeps it from despawning.

An infected NPC is not a tamed pet, and that distinction drove the whole design: the symbiote inside it does the moving and the fighting. Tendrils whip, drag a target closer, or lift it and drive it into the ground. A villager fights as hard as anything else, because none of that comes from the body. NPCs that could already fight keep their own attacks and get the tendrils on top.

It never attacks you or another of yours, it defends itself and it defends you, and it will not burn in daylight — an escort that dies at dawn is not an escort. Order it with an empty hand: right click cycles Stay, Follow and Wander, sneak and right click reads it back. Or by name, from anywhere: /knull follow <name>, stay, wander, come, die, release, list. No OP needed, and it only ever reaches NPCs that are yours.

Two config lists decide who can be infected at all: one that can never be touched whatever else is set, and one that, if you write anything in it, becomes the only thing allowed. Both read a single entity, a whole mod id, a tag, or a wildcard pattern.

Tearing walls and doors

Doors come off the hinges with a tendril that reaches the door, grips it and pulls, because I wanted to see the thing being torn out rather than a block quietly turning into an item.

Walls come out 3x3, in the plane of the face you are looking at, and the blocks either drop or go straight to your inventory. What can be torn depends on what you are: an ordinary symbiote takes what an explosion could take, while a royal or the Knull take obsidian, netherite and the rest of what normally does not move — never bedrock.

"Blast resistant" lies for a lot of modded blocks — plenty of them resist through code, an event or a permission while carrying ordinary resistance — so two config lists decide the rest by hand. One marks blocks only the strong grip can take; the other marks what nothing takes, ever. Both read a block id, a whole mod id, a tag, or a wildcard pattern, so securitycraft or *_ore covers a mod or a whole family in one line.

Working with other mods

Locks Reforged. The symbiote works as a skeleton key, but not instantly: a tendril goes to the lock and works at it for a few seconds. Walk away and it stops.

Cuffed. If you get cuffed, the symbiote works you out of them on its own after a while.

Palladium and KubeJS are optional and only matter for the ceiling pose. PixelGore is optional and only matters for one scene. Everything else works without any of them.

There is also a config switch for whether the base mod's ground slam breaks the block under the target. It is on by default and does exactly what it does today; turning it off is there for anyone who slams indoors and would rather keep the floor.

Tuning it

More than a hundred and thirty options across sixteen sections, and every feature has a master switch. The crawl exposes its speeds, its attach range, the ceiling hitbox and both cameras — first person and third person carry separate numbers on purpose, because they are two different shots of the same moment. The gallows and the feast expose radius, target count, timing, healing and cooldown. The weakness items expose how much they give back, the offering exposes what the void asks for, and the Knull and the infected have sections of their own.

Forge never overwrites a config that already exists, so anything you have set stays set through an update — including when a default changes underneath it. If a setting seems to do nothing after updating, check whether your file still carries the old number.

Everything that decides anything runs on the server; the client only ever says which keys are down. It works in singleplayer and on a dedicated server alike, and nothing in it runs on a timer you did not ask for.

Requirements

Minecraft 1.20.1, Forge 47 or newer, and the Symbiote mod by kitigawa, version 1.1.0 or newer. Palladium, KubeJS and PixelGore are optional, as described above. Locks Reforged and Cuffed are optional and only add what is in their own section.

Symbiote Tweaks (PT-BR)

Addon não oficial para o Symbiote: A Bonding Experience, do kitigawa. Não é feito por ele, não tem endosso dele e não tem qualquer vínculo com ele.

O Symbiote é obrigatório. Sem ele este mod não faz nada.

Nenhum arquivo, asset ou código do Symbiote está incluído neste download — tudo o que está neste jar foi escrito para este projeto. O que ele faz é se ligar às classes internas do Symbiote. Elas não são uma API publicada, e as minhas também não, então não existe ponto de apoio estável entre os dois: uma atualização do Symbiote é o motivo mais provável para este addon quebrar.

Reporte bugs aqui, não na página do Symbiote. Se algo quebrar com os dois instalados, abra uma issue neste projeto. Não leve problema de addon para o kitigawa — ele não escreveu isto e não tem como consertar.

Symbiote: A Bonding Experience, por kitigawa — [link]

O que é meu e o que não é

Tudo neste jar é código que eu escrevi. Nenhum arquivo, asset ou linha do Symbiote está incluído no download.

Meu: a escalada de parede e o pendurar no teto, incluindo a caixa do teto, o tratamento de hitbox e de sufocação, a câmera e a ponte da pose. A forca, o banquete, a segunda mão, o arrancar de porta e de parede, o alcançar baú, o desarmar e o bater bolso. O blob que se solta, o controle dele e a cena que te devolve ao corpo. Os itens de fraqueza, a oferenda ao vazio e a cadeia do Regrowth Core. O recuo sob comando. O Knull, a necrosword e os NPCs infectados. Toda opção de config, todo comando e toda tecla.

Do Symbiote, usado em tempo de execução e nunca distribuído aqui: o simbionte em si e tudo que faz ele ser o que é — as strains, o vínculo, a confiança, o estresse, a fome, a estamina e a armadura viva. Várias features daqui leem esse estado pra decidir se podem sequer acontecer. Várias também desenham com o efeito de tentáculo do próprio Symbiote e tocam os sons dele, o que significa que isso sai do jar do kitigawa na sua máquina, não do meu. Alguns botões são colocados dentro da tela de status do Symbiote, ao lado dos dele; os botões são código meu numa tela dele.

Terceiros opcionais: Palladium e KubeJS pra pose do teto, PixelGore pra uma cena, Locks Reforged e Cuffed pro que está na seção deles. Todos são opcionais e o mod roda sem qualquer um deles.

Versão curta: as mecânicas são minhas, o simbionte é dele, e os dois só se encontram enquanto os dois mods estão instalados.

Você escala, e você fica pendurado

Eu queria um simbionte que trata parede como chão. Liga a escalada e a parede vira caminho pra cima. Olha bem pra cima numa saliência e os tentáculos pegam o teto — você atravessa o lado de baixo dele com a câmera afastada e baixa o bastante pra você realmente se ver lá em cima, em vez de encarar o bloco em que está pendurado. Apertar pular te joga da superfície, e agachar ou tocar o chão solta.

A hitbox encolhe enquanto você está pendurado, então o jogo para de tentar te sufocar dentro do teto, e a pose acompanha: o corpo virado sob o bloco com os braços esticados, desenhada pelo registro de animações do Palladium. Essa pose é a única parte que precisa de companhia — o Palladium e um script cliente de KubeJS que vem ao lado do mod, porque o KubeJS só carrega script da pasta da sua própria instância e um jar não tem como entregar um pra ele. Sem os dois a escalada continua te movendo, te segurando e te dando a câmera; só não vira o teu corpo enquanto faz isso.

Coisas nas suas próprias teclas

Eu gosto de habilidade que se aperta, então quase tudo aqui mora numa tecla em vez de num menu.

A forca pendura tudo ao seu redor e joga o que eles carregavam direto no seu inventário. O banquete arrasta a multidão, come, e devolve só a vida que estava faltando — nem um ponto a mais, porque cura que passa do ponto transforma toda briga em não-evento. Tem um salto de tentáculo, uma segunda mão que bate dois inimigos um no outro, uma porta arrancada da dobradiça, um pedaço 3x3 de parede puxado inteiro, um baú aberto do outro lado da sala, uma arma tirada da mão de um mob, e um bolso batido sem o jogador perceber.

Cada uma delas é uma tecla sua, e todas são construídas com espaço pra modificador, então qualquer uma pode ser remapeada pra tecla simples ou pra outra combinação de Alt, Ctrl ou Shift sem brigar com o resto do seu pack.

Mandando um pedaço de você

Uma parte do simbionte se solta e anda sozinha enquanto o seu corpo fica onde está. Você guia ela com as suas teclas normais de movimento, e o que aparece na tela é a ponta do tentáculo com o cordão ainda ligado ao seu peito — ela nunca se desprende de você.

Ela só sente som e fogo, e só enquanto você ainda tiver essas fraquezas. Todo o resto — espada, flecha, queda, explosão, veneno — passa por ela, porque um membro de reconhecimento que morre pra uma flecha é um membro que ninguém usa.

Ela pode tomar um corpo, e sair de um é cena e não teleporte: dois tentáculos pegam o hospedeiro pelos lados e o rasgam, e você sai do meio. Com o PixelGore instalado as metades são dele; sem ele o corpo simplesmente deixa de existir e o resto acontece igual.

Fraquezas que cortam dos dois lados

Um hospedeiro ligado apanha mais de dano sônico e de fogo, e eu queria um jeito de comprar isso de vez em vez de carregar um item de contramedida pra sempre.

O Sound Muffler tira a audição do simbionte — sino para de atordoar, e o grito do Warden para de carregar dano e estresse extras. O Heat Damper tira o medo de fogo. Os dois se montam a partir de uma Void Piece, que o vazio devolve em troca de uma oferenda, e os dois são consumidos no uso.

Nenhum dos dois é acessório, de propósito. Uma fraqueza que volta quando você tira um trinket não foi removida, foi estacionada.

O Regrowth Core

Uma cadeia de quatro passos, e a ficção é a do Deadpool: o câncer é o que mata e a regeneração é o que salva, e é a briga entre os dois que traz ele de volta inteiro. Por isso o caminho passa pelo câncer antes da cura, e não depois.

Poção de Fraqueza longa com Veneno II faz a Potion of Cancer. Maçã dourada encantada com Regeneração II faz a Super Regeneration. As duas juntas fazem a Super Cancer, e a Super Cancer com uma Void Piece faz o Core. As poções são casadas por NBT, então a receita exige a garrafa certa — fraqueza longa, veneno II, regeneração II — e não qualquer uma daquele tipo.

Ele recua quando você manda

Essa é pra roleplay. Eu queria jogar um hospedeiro que aprendeu a comandar o que carrega dentro, em vez de um que convive com isso, e essa história precisa de um momento em que o simbionte fica quieto porque você mandou.

Uma tecla, sem checagem de confiança, sem negociação e sem cronômetro — vale até você devolver o controle. Enquanto está recuado o simbionte para de agir por conta própria. A exceção é sua pra fazer, porque pedir Protect Me ou Hunt no menu radial dele é mandar ele agir.

Se a história que você quer é a outra — o simbionte com vontade própria e a tensão que vem junto — é isso que o Symbiote já te dá, e você tem isso jogando sem este addon.

O Knull

Uma variante separada, colocada por cima de qualquer strain que o hospedeiro já tivesse, e limitada a um jogador por mundo. Se reivindica por comando e se tira pelo mesmo comando, então dono de servidor nunca fica preso com ela. Eu queria uma versão da fantasia em que o hospedeiro é o topo da cadeia, e um mundo onde só um jogador pode ser.

O Knull bate mais e apanha menos, a estamina e a armadura viva dele ficam cheias, e a tela de status carrega a identidade dele. Todos os números estão na config, inclusive os que a tela mostra.

A necrosword. Sacada por tecla própria. O botão direito não golpeia — ele dispara um projétil que não dá dano nenhum e marca o que encostar. Depois de um instante a marca abre: tentáculos irrompem do alvo marcado, arrastam todo mob em volta pra dentro, e aquilo implode. O projétil não dá dano de propósito, pra nada morrer antes da habilidade acontecer.

NPCs infectados. Agachado + botão direito num mob nomeado, com a necrosword na mão, e o simbionte toma ele. Só o Knull faz isso, e só em mob que tem nome — um aldeão sem nome é população, um nomeado é alguém, e o nome também é o que impede ele de sumir.

Um NPC infectado não é bicho domado, e essa distinção guiou o desenho inteiro: o simbionte dentro dele é quem anda e quem briga. Os tentáculos chicoteiam, arrastam o alvo pra perto, ou erguem ele e enterram no chão. Um aldeão briga tão bem quanto qualquer coisa, porque nada disso vem do corpo. NPC que já sabia brigar continua com o ataque dele e ganha os tentáculos por cima.

Ele nunca ataca você nem outro que seja seu, se defende e te defende, e não queima no sol — escolta que morre ao amanhecer não é escolta. Manda nele com a mão vazia: botão direito alterna Ficar, Seguir e Vagar, agachado + botão direito mostra a ficha. Ou pelo nome, de qualquer lugar: /knull follow <nome>, stay, wander, come, die, release, list. Não precisa de OP, e só alcança NPC que é seu.

Duas listas na config decidem quem pode ser infectado: uma que nunca pode, aconteça o que acontecer, e outra que, se você escrever algo nela, passa a ser a única coisa permitida. As duas leem uma entidade, um mod id inteiro, uma tag, ou um padrão com curinga.

Arrancando paredes e portas

Porta sai da dobradiça com um tentáculo que vai até ela, agarra e puxa, porque eu queria ver a coisa sendo arrancada em vez de um bloco virando item em silêncio.

Parede sai em 3x3, no plano da face que você está olhando, e os blocos ou caem ou vão direto pro inventário. O que dá pra arrancar depende do que você é: um simbionte comum tira o que uma explosão tiraria, enquanto um royal ou o Knull tiram obsidiana, netherite e o resto do que normalmente não se move — bedrock nunca.

"Resistente a explosão" mente pra muito bloco de mod — vários resistem por código, por evento ou por permissão, com resistência normal — então duas listas na config decidem o resto na mão. Uma marca blocos que só a pegada forte tira; a outra marca o que ninguém tira, nunca. As duas leem um bloco, um mod id inteiro, uma tag, ou um padrão com curinga, então securitycraft ou *_ore cobre um mod ou uma família inteira numa linha.

Junto com outros mods

Locks Reforged. O simbionte funciona como chave mestra, mas não na hora: um tentáculo vai até o cadeado e trabalha nele por alguns segundos. Se afastar, ele para.

Cuffed. Se você for algemado, o simbionte te tira das algemas sozinho depois de um tempo.

Palladium e KubeJS são opcionais e só importam pra pose do teto. PixelGore é opcional e só importa pra uma cena. Todo o resto funciona sem qualquer um deles.

Existe também uma chave na config pra decidir se o ground slam do mod base quebra o bloco embaixo do alvo. Vem ligada e faz exatamente o que faz hoje; desligar existe pra quem usa o slam dentro de casa e prefere manter o chão.

Ajustando

Mais de cento e trinta opções em dezesseis seções, e toda feature tem uma chave mestra. A escalada expõe as velocidades, o alcance de agarrar, a hitbox do teto e as duas câmeras — primeira e terceira pessoa carregam números separados de propósito, porque são dois enquadramentos diferentes do mesmo momento. A forca e o banquete expõem raio, número de alvos, tempo, cura e recarga. Os itens de fraqueza expõem quanto devolvem, a oferenda expõe o que o vazio pede, e o Knull e os infectados têm seções próprias.

O Forge nunca sobrescreve uma config que já existe, então o que você ajustou continua ajustado depois de uma atualização — inclusive quando um padrão muda por baixo. Se uma opção parecer não fazer nada depois de atualizar, confere se o teu arquivo ainda está com o número velho.

Tudo que decide alguma coisa roda no servidor; o cliente só diz quais teclas estão apertadas. Funciona em singleplayer e em servidor dedicado igualmente, e nada nele roda num relógio que você não pediu.

Requisitos

Minecraft 1.20.1, Forge 47 ou mais novo, e o mod Symbiote do kitigawa, versão 1.1.0 ou mais nova. Palladium, KubeJS e PixelGore são opcionais, como descrito acima. Locks Reforged e Cuffed são opcionais e só acrescentam o que está na seção deles.