Facade By Pycoder

# FacadeByPycoder 1.0.0 FacadeByPycoder 1.0.0 is the first public release of FacadeByPycoder, a decorative building mod for Minecraft 1.20.1 on Forge, created by Pycoder. This mod lets players create facade blocks that look like vanilla or supported mod blocks while behaving as safe decorative blocks. It is designed for creative building, map making, display scenes, themed structures, and modpack environments where builders want more visual freedom without keeping the original block behavior. ## Main Features - Decorative facade blocks for vanilla Minecraft and supported mod blocks. - Source blocks keep their appearance as decoration, but do not keep their original interactions or special effects. - Configurable mod support, allowing players or pack makers to choose which mods provide facade blocks. - In-game command for obtaining facade blocks and the projection tool. - Empty-hand interaction for cycling facade appearances after placement. - Ghost Mode for passing through facade blocks while building or checking structures. - Projection tool for selecting an area and exporting it into common schematic or blueprint formats. - Exported projection files restore facade blocks back into their visible source blocks. - English and Chinese language support. ## How to Get Facade Blocks Use the `/fbpget` command in-game. ### Get a Facade Block ```mcfunction /fbpget ``` Examples: ```mcfunction /fbpget minecraft:stone /fbpget minecraft:oak_door /fbpget create:andesite_door ``` The command gives you a facade block based on the selected source block. The facade keeps the visual appearance for building, but it does not keep the original block's gameplay behavior. The command suggestions only show blocks that can be used as facade sources. Blocks such as air, fluids, and other unsuitable entries are filtered out. ### Get the Projection Tool ```mcfunction /fbpget stick ``` This gives the FacadeByPycoder projection tool. It uses a stick-like appearance, but it is a separate item from the vanilla stick. ## Changing a Placed Facade Block Some facade blocks have more than one visual form. After placing a facade block, use an empty hand to cycle its appearance: - Empty-hand right-click: switch to the next appearance. - Empty-hand Shift + right-click: switch to the previous appearance. This is useful for blocks such as doors, machinery-like blocks, and other blocks that have multiple visual forms. ## Ghost Mode Ghost Mode is designed for building and inspection. - Default key: `G` - Press `G` to toggle Ghost Mode on or off. - While Ghost Mode is enabled, you can pass through FacadeByPycoder facade blocks. - Facade blocks are highlighted with a green visual guide while Ghost Mode is active. Ghost Mode is useful when checking interiors, hidden spaces, dense decorative builds, or large facade-based structures. ## Projection Tool Usage The projection tool is used to select an area and save it as a projection or schematic file. ### Selection Controls Hold the FacadeByPycoder projection tool: - Left-click a block: select the first position. - Right-click a block: select the second position. - The first selected position is highlighted in red. - The second selected position is highlighted in blue. - When both positions are selected, the selected area is shown as a virtual selection box. ### Save the Selection After both positions are selected: - Shift + right-click with the projection tool to open the save file dialog. - Choose the file name and export format. - The exported structure uses the original visible blocks instead of FacadeByPycoder facade blocks. ### Supported Export Formats FacadeByPycoder 1.0.0 supports four export formats: - `.schem` - a commonly used modern schematic format. - `.schematic` - a classic schematic format. - `.litematic` - the common Litematica format. - `.nbt` - a blueprint-style format suitable for Create-style structure use. ## Configuration File FacadeByPycoder creates a common configuration file after the game starts with the mod installed. The configuration lets players and modpack makers adjust which blocks are available and how facade blocks behave. ### `allowedModIds` Controls which mods can provide facade blocks. Example: ```toml allowedModIds = ["minecraft", "create"] ``` Only blocks from the listed mod IDs can become facade blocks. This is useful for controlling modpack balance and keeping the facade list focused. ### `hardness` Controls how hard facade blocks are to break. Use this if you want facade blocks to be easier or harder to remove. ### `explosionResistance` Controls how resistant facade blocks are to explosions. This is useful for servers or maps that need durable decorative blocks. ### `enableInSurvival` Controls whether the `/fbpget` command can be used in Survival Mode. ### `enableInAdventure` Controls whether the `/fbpget` command can be used in Adventure Mode. ### `ghostAlpha` Controls the transparency of the Ghost Mode visual guide. Lower values make the guide more transparent. Higher values make it more visible. ## Intended Use FacadeByPycoder 1.0.0 is mainly intended for: - Creative building. - Map making. - Decorative builds. - Display scenes. - Modpack building tools. - Creating safe visual-only versions of blocks from vanilla Minecraft and supported mods. ## Known Limitations - Some complex animated or special-looking blocks from other mods may not look exactly like their original versions in every situation. - Some mechanical-style blocks may receive more visual polish in future versions. - The mod focuses on decoration and building. It does not aim to recreate the gameplay functions of the original source blocks. ## Future Plans - Improve visual matching for more complex modded blocks. - Continue improving projection export behavior. - Add more visual polish for special block appearances. - Improve compatibility based on player and modpack feedback. ## Notes FacadeByPycoder 1.0.0 is built for Minecraft 1.20.1 on Forge and was created by Pycoder. ## 中文翻译 # FacadeByPycoder 1.0.0 FacadeByPycoder 1.0.0 是 FacadeByPycoder 的第一个公开发布版本。这是一个适用于 Minecraft 1.20.1 Forge 端的装饰建筑类模组，作者为 Pycoder。 这个模组可以让玩家创建外观类似原版或受支持模组方块的伪装方块，但这些方块本身只作为安全的装饰方块使用。它适合创意建筑、地图制作、展示场景、主题建筑以及整合包环境，让建筑玩家获得更多视觉自由度，同时不保留原方块的行为。 ## 主要功能 - 为 Minecraft 原版和受支持模组方块添加装饰用伪装方块。 - 来源方块只保留外观用于建筑，不保留原本的交互或特殊效果。 - 可配置模组支持，玩家或整合包作者可以决定哪些模组提供伪装方块。 - 提供游戏内命令，用于获取伪装方块和投影工具。 - 支持放置后使用空手交互切换伪装方块外观。 - 添加幽灵模式，方便玩家在建筑和检查结构时穿过伪装方块。 - 添加投影工具，可选择区域并导出为常见结构或蓝图格式。 - 投影导出时会将伪装方块还原为其可见的来源方块。 - 支持英文和中文语言。 ## 如何获取伪装方块 在游戏中使用 `/fbpget` 命令。 ### 获取伪装方块 ```mcfunction /fbpget <方块ID> ``` 示例： ```mcfunction /fbpget minecraft:stone /fbpget minecraft:oak_door /fbpget create:andesite_door ``` 这个命令会给予你基于指定来源方块的伪装方块。伪装方块会保留来源方块的视觉外观用于建筑，但不会保留来源方块的原始玩法行为。 命令补全只会显示适合作为伪装来源的方块。空气、流体以及其它不适合的条目会被过滤。 ### 获取投影工具 ```mcfunction /fbpget stick ``` 这个命令会给予 FacadeByPycoder 的投影工具。它使用类似木棍的外观，但它是独立物品，不会改变原版木棍。 ## 切换已放置伪装方块的外观 部分伪装方块拥有不止一种可见外观。放置伪装方块后，可以使用空手进行切换： - 空手右键：切换到下一个外观。 - 空手 Shift + 右键：切换到上一个外观。 这适合用于门、机械外观方块以及其它拥有多种可见形式的方块。 ## 幽灵模式 幽灵模式用于建筑和检查结构。 - 默认快捷键：`G` - 按下 `G` 可开启或关闭幽灵模式。 - 幽灵模式开启时，玩家可以穿过 FacadeByPycoder 的伪装方块。 - 幽灵模式开启时，伪装方块会显示绿色视觉提示。 幽灵模式适合检查内部空间、隐藏结构、密集装饰建筑或大型伪装方块建筑。 ## 投影工具用法 投影工具用于选择区域并保存为投影或结构文件。 ### 选择区域 手持 FacadeByPycoder 投影工具： - 左键点击方块：选择第一个坐标点。 - 右键点击方块：选择第二个坐标点。 - 第一个坐标点会以红色高亮显示。 - 第二个坐标点会以蓝色高亮显示。 - 两个坐标点都选择后，会显示所选区域的虚拟选区框。 ### 保存选区 当两个坐标点都已经选择后： - 手持投影工具 Shift + 右键，打开保存文件对话框。 - 选择文件名和导出格式。 - 导出的结构会使用可见的来源方块，而不是 FacadeByPycoder 的伪装方块。 ### 支持的导出格式 FacadeByPycoder 1.0.0 支持四种导出格式： - `.schem` - 常见的现代投影格式。 - `.schematic` - 经典投影格式。 - `.litematic` - 常用的 Litematica 格式。 - `.nbt` - 适合机械动力蓝图类用途的结构格式。 ## 配置文件 安装模组并启动游戏后，FacadeByPycoder 会生成通用配置文件。 配置文件可用于调整哪些方块可用，以及伪装方块的基础行为。 ### `allowedModIds` 控制哪些模组可以提供伪装方块。 示例： ```toml allowedModIds = ["minecraft", "create"] ``` 只有列表中的模组 ID 对应的方块可以生成伪装方块。这个配置适合整合包作者控制可用范围，也适合玩家保持列表整洁。 ### `hardness` 控制伪装方块的挖掘硬度。 如果你希望伪装方块更容易或更难移除，可以调整这个选项。 ### `explosionResistance` 控制伪装方块的爆炸抗性。 这个选项适合需要高耐久装饰方块的服务器或地图。 ### `enableInSurvival` 控制 `/fbpget` 命令是否可以在生存模式中使用。 ### `enableInAdventure` 控制 `/fbpget` 命令是否可以在冒险模式中使用。 ### `ghostAlpha` 控制幽灵模式视觉提示的透明度。 数值越低，提示越透明；数值越高，提示越明显。 ## 适用场景 FacadeByPycoder 1.0.0 主要适合： - 创意建筑。 - 地图制作。 - 装饰建筑。 - 展示场景。 - 整合包建筑工具。 - 创建 Minecraft 原版和受支持模组方块的安全纯外观版本。 ## 已知不足 - 一些动画复杂或外观特殊的模组方块，在所有场景下可能无法与原方块完全一致。 - 某些机械类复杂方块未来还可以继续进行视觉优化。 - 本模组重点是装饰和建筑用途，并不用于复刻来源方块的原始玩法功能。 ## 后续计划 - 改进更多复杂模组方块的视觉匹配效果。 - 持续优化投影导出体验。 - 为特殊方块外观补充更多细节表现。 - 根据玩家和整合包作者的反馈继续提升兼容性。 ## 说明 FacadeByPycoder 1.0.0 适用于 Minecraft 1.20.1 Forge 端，作者为 Pycoder。