# PolyMc-Extra
\nThis is a server-side library and a tool for providing automatic patching mods for PolyMc. It functions similarly to PolyMc but is more powerful. It enables automatic patching of certain mods, and its patching functionality can be controlled by modifying configuration files.<\/p>\n
## The following registry entries were processed by the patch
\nList: Attribute, EntityType, SoundEvent, ComponentType, EnchantmentEffectComponentType, EnchantmentLocationBaseEffectType, EnchantmentEntityEffectType, StatusEffect, Potion, ScreenHandlers, ConsumeEffectType, StatType, CustomStat, PoiType, ItemGroup, Item, Block, BlockEntityType, Profession<\/p>\n
## Runtime Lifecycle:
\n1. Register the built-in ExtraModelType
\n2. Register Special Entity Mappings
\n3. Scan and execute all module’s “polymc-extra” entry points (PolyMcExtraEntrypoint.class)
\n4. Before all static registry entries freeze: Read the configuration file, iterate through the registry, and patch each missing item (server-only)
\n5. Verify item components integrity
\n6. Scan for required resources in JAR files and generate resource packages<\/p>\n
## For player\/server owners\/mod pack makers:
\nIt can automatically repair the state of corresponding polymer blocks for most mods, allowing Vanilla clients to join servers with mods.<\/p>\n
## For mod developers:
\nIt provides several APIs and tools for developers to patch complex mods; for others, you can ask questions on Discord.<\/p>\n
### Knowledge required<\/p>\n
You should first learn how to use some libraries.<\/p>\n
* About Polymer
\n* About blockbench-import-library
\n* About polydex
\n* About PolyMc<\/p>\n
### Development Environment<\/p>\n
1. Create a libs folder in your module project directory.
\n2. Download the JAR file and place it in the libs folder in your module project directory.
\n3. Add the following content to build.gradle:<\/p>\n
“`
\nrepositories {
\n maven { url “https:\/\/maven.nucleoid.xyz” }
\n maven { url “https:\/\/maven.tomalbrc.de” }
\n maven { url “https:\/\/api.modrinth.com\/maven” }
\n maven { url “https:\/\/maven.architectury.dev\/” }
\n maven {
\n url “https:\/\/maven.theepicblock.nl”
\n content { includeGroup(“nl.theepicblock”) }
\n }
\n flatDir {
\n dirs ‘libs’
\n }
\n}
\ndependencies {
\n modImplementation(“eu.pb4:polymer-core:[${polymer_version}]”)
\n modImplementation(“eu.pb4:polymer-blocks:[${polymer_version}]”)
\n modImplementation(“eu.pb4:polymer-resource-pack:[${polymer_version}]”)
\n modImplementation(“eu.pb4:polymer-resource-pack-extras:[${polymer_version}]”)
\n modImplementation(“eu.pb4:polymer-virtual-entity:[${polymer_version}]”)
\n modImplementation(“eu.pb4:polymer-autohost:${polymer_version}”)
\n modImplementation(“eu.pb4:polymer-networking:[${polymer_version}]”)
\n modImplementation(“nl.theepicblock:resource-locator-api:${project.resource_locator_version}”)
\n modImplementation(“eu.pb4:factorytools:[${factorytools_version}]”)
\n modImplementation(“eu.pb4:sgui:[${sgui_version}]”)
\n modImplementation(“xyz.nucleoid:server-translations-api:${server_translation_api_version}”)<\/p>\n
modImplementation files(‘libs\/PolyMc-Extra-XXXXXXX.jar’)
\n modCompileOnly ‘maven.modrinth:polydex:XXXXXX’
\n}
\n“`<\/p>\n
### Patch Code Example
\n“`
\npublic class PolymerifyRegistry implements PolyMcExtraEntrypoint {<\/p>\n
@Override
\n public void onInitialize() {
\n PolymerifyRegistry.initialize();
\n PolyMcExtraPacks.NAMESPACES.add(getNamespace());
\n }<\/p>\n
public static void initialize() {
\n registerPolymerBlock(BlockRegistry.XXX, XXXPolymerBlock.INSTANCE);
\n registerPolymerItem(BlockRegistry.XXX, new PolymerItemImpl(BlockRegistry.XXX.asItem()));
\n }<\/p>\n
public static void registerPolymerBlock(Block block, PolymerBlock polymerBlock) {
\n ResourceLocation key = BuiltInRegistries.BLOCK.getKey(block);
\n PolymerBlock.registerOverlay(block, polymerBlock);
\n if (polymerBlock instanceof BlockWithElementHolder elementHolder) {
\n BlockWithElementHolder.registerOverlay(block, elementHolder);
\n }
\n PolyMcExtra.LATE_INIT.add(new Runnable() {
\n @Override
\n public void run() {
\n if (PolymerBlockHelper.testJsonExist(block)) {
\n BlockStateModelManager.addBlock(key, block);
\n }
\n }
\n });
\n }<\/p>\n
public static void registerPolymerItem(ItemLike item, PolymerItem polymerItem) {
\n PolymerItem.registerOverlay(item.asItem(), polymerItem);
\n }<\/p>\n
@Override
\n public String getNamespace() {
\n return MOD_ID;
\n }
\n}<\/p>\n
public class XXXPolymerBlock {
\n public static final BlockState OVERLAY_0 = PolymerBlockResourceUtils.requestEmpty(BlockModelType.ACTIVE_PRESSURE_PLATE);
\n public static final BlockState OVERLAY_1 = PolymerBlockResourceUtils.requestEmpty(BlockModelType.KELP_BLOCK);
\n public static final BaseFactoryBlock INSTANCE = new BaseFactoryBlock(OVERLAY_0, false, BlockStateModel::midRange) {
\n @Override
\n public BlockState getPolymerBlockState(BlockState state, PacketContext context) {
\n if (state.hasProperty(BlockStateProperties.WATERLOGGED) && state.getValue(BlockStateProperties.WATERLOGGED)) {
\n return OVERLAY_1;
\n }
\n return super.getPolymerBlockState(state, context);
\n }
\n };
\n}<\/p>\n
“`<\/p>\n
## Example Config:
\nThe configuration file is located at `\/config\/polymc-extra.json`
\n“`
\n{
\n\t“DisabledOpaqueBlocks”: [],
\n\t“CustomBlockModelTypeMappings”: {
\n\t\t“citymod:stone_table”: “BLOCK_DISPLAY_ENTITY”,
\n\t\t“citymod:road_block”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:road_yellow”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:road_yellow_connect”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:road_white_connect”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:road_yellow_double”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:road_zebra_crossing”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:roadblock_oblique”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:roadblock_yellow_oblique”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:roadblock_double_oblique”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:zebracrossing_oblique”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:road_straight”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“citymod:road_diamond”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:modern_light”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:computer_mouse”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:black_mirror”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:laptop”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:modern_clock”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:led_floor_lamp”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:shower”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:portable_laptop_stand”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:laptop_closed_portable_laptop_stand”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:cooktop”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:keyboard”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:monitor_setup”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:shower”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:socket”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:modern_chair”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“js_furniture_mod:wood_chair”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“^js_furniture_mod:midi_.+$”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“^js_furniture_mod:.*”: “BLOCK_DISPLAY_ENTITY”,
\n\t\t“^skniro_furniture:.*_(drawer|cabinet|fridge|kitchen_sink|oven|tv_stand)$”: “BLOCK_DISPLAY_ENTITY”,
\n\t\t“^skniro_furniture:.*_(bed|cushion|sofa|window(?:_style.*)?|plate|chair(?:_.*)?|lamp)$”: “BLOCK_DISPLAY_ENTITY_NO_COLLISION”,
\n\t\t“^skniro_furniture:.*_window(_.*)?$”: “CLOSEABLE_BLOCK”,
\n\t\t“^skniro_furniture:.*_(door)$”: “CLOSEABLE_BLOCK”,
\n\t\t“^skniro_furniture:.*_glass_table”: “BLOCK_DISPLAY_ENTITY”,
\n\t\t“terrestria:cattail”: “WATER_PLANT”,
\n\t\t“terrestria:andisol_grass_block”: “POLYMER:BIOME_TRANSPARENT_BLOCK”,
\n\t\t“^storagedelight:.*$”: “BLOCK_DISPLAY_ENTITY”,
\n\t\t“^terrestria:.*_log$”: “BLOCK_DISPLAY_ENTITY”
\n\t},
\n\t“CustomEntityModelMappings”: {
\n\t\t“js_furniture_mod:chair_entity”: “polymc-extra:chair”,
\n\t\t“js_furniture_mod:sofa_entity”: “polymc-extra:chair”,
\n\t\t“skniro_furniture:chair_entity”: “polymc-extra:chair”,
\n\t\t“skniro_furniture:sofa_entity”: “polymc-extra:chair”,
\n\t\t“skniro_furniture:cushion_entity”: “polymc-extra:chair”,
\n\t\t“citymod:explode_bow_projectile”: “minecraft:arrow”,
\n\t\t“citymod:rifle_legacy_projectile”: “minecraft:arrow”
\n\t},
\n\t“CustomModelExpansionMappings”: {
\n\t\t“js_furniture_mod:sofa”: 0.0,
\n\t\t“js_furniture_mod:wood_light_table”: 0.0,
\n\t\t“js_furniture_mod:led_floor_lamp_rgb_off”: 0.0,
\n\t\t“js_furniture_mod:led_floor_lamp_rgb_off_2”: 0.0,
\n\t\t“js_furniture_mod:studio_light”: 0.0,
\n\t\t“citymod:road_block”: 0.0,
\n\t\t“citymod:road_yellow”: 0.0,
\n\t\t“citymod:road_yellow_connect”: 0.0,
\n\t\t“citymod:road_white_connect”: 0.0,
\n\t\t“citymod:road_yellow_double”: 0.0,
\n\t\t“citymod:road_zebra_crossing”: 0.0
\n\t}
\n}
\n“`<\/p>\n
## Commands
\n* \/polymc-extra:
\n * export-extra-block-models-mappings: Export the PolyMc-processed block map to ExtraBlockMapping.txt
\n * get-all-model-types: Showing all block mapping types
\n * get-client-state: Showing the true mapping and overlay mapping of the square the crosshair is pointing at.
\n * get-item-info: Showing the real ID of the item in your hand and its component information.<\/p>\n
## What this library\/mod doesn’t do
\nIt does not support client-side rendering.<\/p>\n
If the module uses ASM to modify certain enums or replaces Vanilla’s registry entries, it will cause some abnormal errors.<\/p>\n
## License
\nThis mod is partially based on code from enderscape-patch and PolyMc that are licensed with GNU Lesser General Public License v3.0 and GNU Lesser General Public License 3.0<\/p>\n","protected":false},"excerpt":{"rendered":"
Automatically patch mods so that regular players don’t need to install mods to join your server!<\/p>\n","protected":false},"featured_media":123703,"template":"","meta":{"_minecraft_slug":"polymc-extra","_minecraft_project_id":"Tz04BvZF","_minecraft_author":"SAGUMEDREAM","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":323,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"polymc-extra.zip","_minecraft_size_bytes":3685716,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T17:06:11.369121Z","_minecraft_date_created":"2026-01-29T01:34:56.060659Z","_minecraft_date_modified":"2026-02-04T09:07:47.291292Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/polymc-extra","_minecraft_icon_attachment_id":123703,"_minecraft_imported_at":"2026-06-07T06:34:11+00:00","_minecraft_import_hash":"f8b7f1e74aff1818e924cd865a96e4bd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873],"mod_loader":[99],"minecraft_version":[40,41,79,80,81],"class_list":["post-123702","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_loader-fabric","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n