SchemImporter

# SCHEM IMPORTER Is a Minecraft plugin for (https://papermc.io/downloads/paper) that allows importing schematics from download URLs into the FAWE schematics folder. **Features:** - Import schematics from HTTP/HTTPS URLs - URL rewriting for schematic sharing sites (IntellectualSites, schem.sn, BuiltByBit, ...) - Host whitelist with bypass permission - File size limits and download timeouts - Overwrite protection with bypass permission - Custom filename support - Async downloads to prevent server lag - Logging to console on successful imports - Config reload command - All messages are editable - Supports .schem, .schematic, and .nbt extensions **Permissions:** - `schemimporter.import`: Allows using /import to download schematics - `schemimporter.import.other`: Allows importing schematics on behalf of other players (reserved for future features) - `schemimporter.bypass.whitelist`: Allows downloading from any host, bypassing the whitelist - `schemimporter.bypass.overwrite`: Allows overwriting existing schematic files - `schemimporter.reload`: Allows reloading the SchemImporter config via /import reload **Config:** <details> <summary>Spoiler</summary> ```yaml # ───────────────────────────────────────────────────────────────────────────── # SchemImporter — config.yml # Plugin by DippyCoder # ───────────────────────────────────────────────────────────────────────────── # ── Schematic Directory ─────────────────────────────────────────────────────── # Path where downloaded schematics will be saved. # Relative paths are resolved from the server root. # Default points to the standard FAWE schematics folder. # # Examples: # plugins/FastAsyncWorldEdit/schematics ← FAWE (default) # plugins/WorldEdit/schematics ← vanilla WorldEdit # schematics ← server root /schematics folder # schematic-directory: "plugins/FastAsyncWorldEdit/schematics" # ── URL Whitelist ───────────────────────────────────────────────────────────── # Controls which hosts players are allowed to download schematics from. # Set enabled: false to allow any host (not recommended on public servers). # Players with the schemimporter.bypass.whitelist permission ignore this list. # # Matching rules: # - "example.com" matches example.com and any subdomain (sub.example.com) # - Comparison is case-insensitive # whitelist: enabled: true hosts: # ── FAWE / WorldEdit schematic sharing sites ─────────────────────────── - "schem.intellectualsites.com" # ── Generic trusted file hosts ───────────────────────────────────────── - "cdn.discordapp.com" - "media.discordapp.net" - "github.com" - "raw.githubusercontent.com" - "objects.githubusercontent.com" - "drive.google.com" - "dropbox.com" - "dl.dropboxusercontent.com" - "paste.gg" - "transfer.sh" # ── Add your own server/CDN here ─────────────────────────────────────── # - "yourserver.net" # - "cdn.yoursite.com" # ── Download Limits ─────────────────────────────────────────────────────────── limits: # Maximum allowed file size in bytes. # The download will be aborted if the file exceeds this size. # Default: 52428800 = 50 MB max-file-size-bytes: 52428800 # Connection and read timeout in seconds for each download attempt. # Increase if you are downloading from slow hosts. download-timeout-seconds: 15 # Whether to allow overwriting an existing schematic with the same filename. # If false, players need the schemimporter.bypass.overwrite permission to overwrite. allow-overwrite: false # ── Permissions (node names only — adjust in plugin.yml for defaults) ───────── # These keys define which permission nodes the plugin checks at runtime. # Change these if you want to use a custom permission string without recompiling. # permissions: import: "schemimporter.import" bypass-whitelist: "schemimporter.bypass.whitelist" bypass-overwrite: "schemimporter.bypass.overwrite" reload: "schemimporter.reload" # ── Messages ────────────────────────────────────────────────────────────────── # All user-facing messages. Supports '&' color codes and the following # placeholders where indicated. # messages: # Prefix prepended to every plugin message. prefix: "&8 &r" # Shown when the command is used incorrectly. usage: "&cUsage: &f/import <url> &7| &f/import reload" # Shown when the player lacks the required permission. no-permission: "&cYou do not have permission to do that." # Shown when a non-player (e.g. console) tries to run a player-only action. # (Currently unused — console is supported — kept for future features.) player-only: "&cThis command can only be used by players." # Shown immediately after the download is initiated. # Placeholder: {url} download-start: "&7Downloading schematic from &f{url}&7..." # Shown when the download completes and the file is saved. # Placeholder: {filename} download-success: "&aS