portifolio-evandrodevbr/3d/FERRAMENTAS.md

Ferramentas do jogo

Programas baixados ficam em 3d/ferramentas/, fora do git (/3d/ferramentas/ no .gitignore), instalados sem sudo e sem login.

programa	versão	licença (frase lida e arquivo)	como baixar	comando sem janela
Tiled (com tmxrasterizer)	1.12.2	GPL-2.0 (editor) e BSD-2-Clause (libtiled, tmxrasterizer). Em COPYING do pacote: "Tiled src/tiled GPL … tmxrasterizer src/tmxrasterizer BSD 2-clause license … The full text of each license is provided in the files LICENSE.GPL and LICENSE.BSD." Arquivo: /app/share/licenses/org.mapeditor.Tiled/tiled/COPYING no Flatpak (o mesmo texto em 3d/ferramentas/tiled/squashfs-root/COPYING no AppImage).	flatpak install --user -y flathub org.mapeditor.Tiled. O AppImage (3d/ferramentas/tiled/, das releases) roda, mas só traz o plugin Qt xcb e falha com QT_QPA_PLATFORM=offscreen; xvfb-run não existe aqui.	env -u DISPLAY -u WAYLAND_DISPLAY flatpak run --env=QT_QPA_PLATFORM=offscreen --command=tiled org.mapeditor.Tiled --export-map json "$PWD/3d/mapa/escritorio.tmx" "$PWD/3d/mapa/escritorio.json" e env -u DISPLAY -u WAYLAND_DISPLAY flatpak run --env=QT_QPA_PLATFORM=offscreen --command=tmxrasterizer org.mapeditor.Tiled "$PWD/3d/mapa/escritorio.tmx" "$PWD/3d/mapa/escritorio.png"
Blender	5.2.2 LTS (blender --version)	GPL. Em /usr/share/doc/blender/readme.html: "Blender can be used freely for any purpose, including commercial use and distribution. It's free and open-source software, released under the GNU GPL licence." Bibliotecas de terceiros em /usr/share/doc/blender/license/license.md.	Já instalado pelo sistema (pacote blender 5.2.2-2 do Manjaro).	blender -b -P script.py
MPFB (MakeHuman para Blender, extensão)	2.0.18 (blender_manifest.toml; build 20261010)	Código GPL-3.0-or-later, recursos CC0. Em LICENSE.md do repositório: "The MPFB source (as defined per the above) is released under GPLv3." e "These assets have been released under CC0 1.0 Universal."; sobre a saída: "As the assets have been released under CC0, there is no limitation on what you can do with this combined output." O zip da extensão não traz arquivo de licença; o manifesto diz license = ["SPDX:GPL-3.0-or-later"].	3d/ferramentas/baixados/add-on-mpfb-v2.0.18.zip de extensions.blender.org (sha256 c075b3e9…2a2dad), instalado só na pasta separada: BLENDER_USER_RESOURCES=$PWD/3d/ferramentas/blender-user blender -b --factory-startup --command extension install-file -r user_default -e 3d/ferramentas/baixados/add-on-mpfb-v2.0.18.zip	BLENDER_USER_RESOURCES=$PWD/3d/ferramentas/blender-user blender -b -P 3d/humano.py (instala os pacotes abaixo na pasta de dados do MPFB se faltarem)

Como mudar o mapa

1. Abrir 3d/mapa/escritorio.tmx no Tiled: flatpak run org.mapeditor.Tiled 3d/mapa/escritorio.tmx.
2. Editar as camadas planta, moveis e marcas e salvar.
3. Rodar bash 3d/mapa.sh: exporta 3d/mapa/escritorio.json e escritorio.png, escreve lib/jogo/mapas/escritorio.ts e monta public/jogo/mapa.glb no Blender.
4. Rodar pnpm test -- lib/jogo/mapas.

O .tmx é a fonte. bash 3d/mapa.sh --gerar refaz o .tmx pelo 3d/mapa.py e apaga o que foi editado à mão.

Pacotes de recursos do MPFB

Baixados de https://files.makehumancommunity.org/asset_packs/<pacote>/<pacote>_cc0.zip (o link files2 da página dá o mesmo arquivo, mas a ~10 KB/s) para 3d/ferramentas/baixados/ e extraídos em 3d/ferramentas/blender-user/extensions/.user/user_default/mpfb/data/. Nenhum zip traz arquivo de licença: a licença lida é o campo "license" de cada recurso em packs/<pacote>.json (dentro do zip) e o cabeçalho dos arquivos usados. Há cabeçalhos AGPL em alguns arquivos de pacotes marcados CC0 (ex.: cortu_cargo_pants/cargo_pants.obj, blindsaypatten_uniform_skin_texture.mhmat); esses ficaram de fora.

pacote	sha256	recursos usados em 3d/humano.py	licença lida
makehuman_system_assets	b542127a…0a0107	pele young_caucasian_male, olhos low-poly, sobrancelha eyebrow001, cabelo short02 (a malha base e o esqueleto mixamo vêm dentro da extensão, recursos CC0 pelo LICENSE.md acima)	CC0 nos 94 itens de packs/makehuman_system_assets.json; cabeçalho dos .mhmat/.mhclo: "This asset was explicitly released as CC0 in september 2020."
shirts01	a5a723b0…3bcd3	namuhekam_male_polo_shirt (autor namuhekam)	"license": "CC0" em packs/shirts01.json; CC0 no cabeçalho do .mhclo, .obj e .mhmat
pants01	e4e0ec60…ad9	toigo_wool_pants (autora MargaretToigo)	"license": "CC0" em packs/pants01.json; CC0 no cabeçalho do .mhclo e .obj
shoes01	ded3f704…5dba9	toigo_ankle_boots_male (autora MargaretToigo)	"license": "CC0" em packs/shoes01.json; CC0 no cabeçalho do .mhclo e .obj
skins01, hair01	7495ab99…4ad9, 49445d69…40c9	baixados, não usados	CC0 no packs/*.json, mas com cabeçalhos AGPL em 2 e 10 arquivos