LoomLimit: Difference between revisions

From aquila
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
LoomLimit replaces the vanilla loom with a custom banner-designing menu that lifts the game's normal 6 layer cap. Server owners can configure how many layers banners are allowed to have, so you can make much more detailed banner designs than vanilla allows.
__NOTOC__
<div style="background: linear-gradient(135deg, #0b132b 0%, #1c2541 50%, #3a506b 100%); border: 2px solid #e0a96d; border-radius: 12px; padding: 2.5em 1.5em; text-align: center; color: #ffffff; box-shadow: 0 4px 20px rgba(0,0,0,0.3); margin-bottom: 2em;">
<h1 style="border: none; color: #f4a261; font-family: 'Georgia', serif; font-size: 2.3em; margin: 0 0 0.3em 0; padding: 0; text-shadow: 0 2px 4px rgba(0,0,0,0.5);">LoomLimit Plugin Documentation</h1>
<p style="font-size: 1.1em; color: #e0e1dd; max-width: 650px; margin: 0 auto; line-height: 1.5;">Custom banner-designing system bypassing vanilla layer restrictions with paged menus, live previews, and duplication stations.</p>
</div>


== What LoomLimit Does ==
<div style="background: #ffffff; border: 1px solid #d1d5db; border-radius: 8px; padding: 1.5em; box-shadow: 0 2px 4px rgba(0,0,0,0.05); margin-bottom: 2em;">
<h2 style="border-bottom: 2px solid #e0a96d; color: #0b132b; margin-top: 0; padding-bottom: 0.3em; font-family: 'Georgia', serif;">What LoomLimit Does</h2>
<p style="line-height: 1.6; color: #374151; margin-bottom: 1em;">LoomLimit replaces the vanilla loom interface with an enhanced custom menu that removes standard limitations and introduces convenient replication tools.</p>
<ul style="color: #374151; line-height: 1.6; margin-top: 0; padding-left: 1.5em;">
<li><b>Configurable Layer Caps:</b> Replaces vanilla's fixed 6-layer limit with a fully customizable maximum pattern layer count.</li>
<li><b>Custom Paged Menu:</b> Provides an intuitive custom loom menu featuring an organized grid to browse all available patterns.</li>
<li><b>Live Preview System:</b> Displays a real-time preview of your banner design as you add layers before committing.</li>
<li><b>Standard Dye Cost:</b> Charges 1 dye per layer just like vanilla, consumed only when collecting the finished banner.</li>
<li><b>Banner Duplication:</b> Includes a station to easily duplicate an already completed banner design onto blank banners without redoing layers by hand.</li>
</ul>
</div>


* Gives banners a '''configurable maximum number of pattern layers''', instead of vanilla's fixed limit of 6
<div style="background: #ffffff; border: 1px solid #d1d5db; border-radius: 8px; padding: 1.5em; box-shadow: 0 2px 4px rgba(0,0,0,0.05); margin-bottom: 2em;">
* Provides a '''custom loom menu''' with a paged grid so you can browse every available pattern
<h2 style="border-bottom: 2px solid #e0a96d; color: #0b132b; margin-top: 0; padding-bottom: 0.3em; font-family: 'Georgia', serif;">How to Design a Banner</h2>
* Shows a '''live preview''' of your banner as you add layers, before you commit to anything
<ol style="color: #374151; line-height: 1.6; margin-top: 0; padding-left: 1.5em;">
* Charges '''1 dye per layer''', same as vanilla, taken only when you apply a layer
<li><b>Open the Menu:</b> Right-click a Loom block to open the custom crafting interface.</li>
<li><b>Insert Materials:</b> Place a banner in the banner slot and a dye in the dye slot.</li>
<li><b>Select a Pattern:</b> Browse the pattern grid at the bottom and click a pattern to preview it on the banner.</li>
<li><b>Confirm Layer:</b> Click <b>Confirm Layer</b> to lock the pattern into the design shown in the output slot without altering your original item yet.</li>
<li><b>Build Layers:</b> Repeat steps 3 and 4 to keep adding layers up to the server's configured maximum limit.</li>
<li><b>Collect Item:</b> Take the completed banner from the output slot when you are satisfied with the design.</li>
</ol>
<p style="line-height: 1.6; color: #374151; margin-top: 1em; margin-bottom: 0;">Use the arrows on either side of the pattern grid to page through options, and check the info book in the middle to track how many layers you've used out of the maximum.</p>
</div>


== How to Use It ==
<div style="background: #ffffff; border: 1px solid #d1d5db; border-radius: 8px; padding: 1.5em; box-shadow: 0 2px 4px rgba(0,0,0,0.05); margin-bottom: 2em;">
<h2 style="border-bottom: 2px solid #e0a96d; color: #0b132b; margin-top: 0; padding-bottom: 0.3em; font-family: 'Georgia', serif;">Duplicating a Banner</h2>
<ol style="color: #374151; line-height: 1.6; margin-top: 0; padding-left: 1.5em;">
<li><b>Set Master Template:</b> Place your finished, patterned banner in the template slot; it acts as a permanent master copy and is never consumed.</li>
<li><b>Add Blanks:</b> Place a blank banner of the same color in the blank slot next to it.</li>
<li><b>Duplicate:</b> Click the <b>Duplicate Banner</b> button to receive an exact copy, consuming one blank banner per copy.</li>
</ol>
<p style="line-height: 1.6; color: #374151; margin-top: 1em; margin-bottom: 0;">The template banner remains in its slot continuously, allowing you to produce as many duplicates as you have blank banners to feed it.</p>
</div>


# '''Right click a Loom block''' to open the custom menu
<div style="background: #ffffff; border: 1px solid #d1d5db; border-radius: 8px; padding: 1.5em; box-shadow: 0 2px 4px rgba(0,0,0,0.05); margin-bottom: 2em;">
# Place a '''banner''' in the banner slot and a '''dye''' in the dye slot.
<h2 style="border-bottom: 2px solid #e0a96d; color: #0b132b; margin-top: 0; padding-bottom: 0.3em; font-family: 'Georgia', serif;">Admin Commands</h2>
# Browse the pattern grid at the bottom and click a pattern to '''preview''' it on the banner.
<table class="wikitable" style="width: 100%; border-collapse: collapse;">
# Click '''Confirm Layer''' to lock that pattern into the banner
<thead>
# Repeat steps 3–4 to keep adding layers, up to the server's configured maximum.
<tr style="background: #f1f5f9; text-align: left;">
# When you're happy with the design, take the item from the '''output slot'''.
<th style="padding: 0.75em; border: 1px solid #cbd5e1; color: #0b132b; width: 35%;">Command</th>
<th style="padding: 0.75em; border: 1px solid #cbd5e1; color: #0b132b;">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;"><code>/loomlimit reload</code></td>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;">Reloads the configuration file and reports the current maximum layer count.</td>
</tr>
</tbody>
</table>
</div>


Use the '''arrows''' on either side of the pattern grid to page through all the available patterns, and check the '''info book''' in the middle for how many layers you've used out of the maximum.
<div style="background: #ffffff; border: 1px solid #d1d5db; border-radius: 8px; padding: 1.5em; box-shadow: 0 2px 4px rgba(0,0,0,0.05); margin-bottom: 2em;">
<h2 style="border-bottom: 2px solid #e0a96d; color: #0b132b; margin-top: 0; padding-bottom: 0.3em; font-family: 'Georgia', serif;">Configuration</h2>
<p style="line-height: 1.6; color: #374151; margin-bottom: 1em;">Server administrators can tweak these settings inside the plugin configuration file:</p>


== Admin Commands ==
<table class="wikitable" style="width: 100%; border-collapse: collapse; margin-bottom: 1em;">
{| class="wikitable"
<thead>
|+
<tr style="background: #f1f5f9; text-align: left;">
!Command
<th style="padding: 0.75em; border: 1px solid #cbd5e1; color: #0b132b; width: 25%;">Setting</th>
!What it does
<th style="padding: 0.75em; border: 1px solid #cbd5e1; color: #0b132b; width: 20%;">Default</th>
|-
<th style="padding: 0.75em; border: 1px solid #cbd5e1; color: #0b132b;">What it controls</th>
|/loomlimit reload
</tr>
|Reloads the config file and reports the current max layer count.
</thead>
|}
<tbody>
<tr>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;"><code>max-patterns</code></td>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;">16</td>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;">Maximum number of pattern layers a banner can possess.</td>
</tr>
<tr style="background: #f8fafc;">
<td style="padding: 0.75em; border: 1px solid #cbd5e1;"><code>gui-title</code></td>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;">Custom Loom</td>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;">The title text shown at the top of the loom menu interface.</td>
</tr>
<tr>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;"><code>patterns-per-page</code></td>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;">27</td>
<td style="padding: 0.75em; border: 1px solid #cbd5e1;">How many patterns are displayed per page in the grid (capped at 27).</td>
</tr>
</tbody>
</table>
 
<p style="line-height: 1.6; color: #374151; margin-bottom: 0;">After making changes to the configuration, execute <code>/loomlimit reload</code> to apply updates instantly without restarting the server.</p>
</div>


== Configuration ==
Server admins can adjust these settings in the plugin's config file:
{| class="wikitable"
|+
!setting
!Deafult
!What it controls
|-
|max-patterns
|16
|Maximum number of pattern layers a banner can have.
|-
|gui-title
|Custom Loom
|The title shown at the top of the loom menu.
|-
|patterns-per-page
|27
|How many patterns are shown per page in the grid (capped at 27).
|}
After changing the config, run <code>/loomlimit reload</code> to apply the changes without restarting the server.
[[Category:Plugins]]
[[Category:Plugins]]

Latest revision as of 13:09, 22 August 2026

LoomLimit Plugin Documentation

Custom banner-designing system bypassing vanilla layer restrictions with paged menus, live previews, and duplication stations.

What LoomLimit Does

LoomLimit replaces the vanilla loom interface with an enhanced custom menu that removes standard limitations and introduces convenient replication tools.

  • Configurable Layer Caps: Replaces vanilla's fixed 6-layer limit with a fully customizable maximum pattern layer count.
  • Custom Paged Menu: Provides an intuitive custom loom menu featuring an organized grid to browse all available patterns.
  • Live Preview System: Displays a real-time preview of your banner design as you add layers before committing.
  • Standard Dye Cost: Charges 1 dye per layer just like vanilla, consumed only when collecting the finished banner.
  • Banner Duplication: Includes a station to easily duplicate an already completed banner design onto blank banners without redoing layers by hand.

How to Design a Banner

  1. Open the Menu: Right-click a Loom block to open the custom crafting interface.
  2. Insert Materials: Place a banner in the banner slot and a dye in the dye slot.
  3. Select a Pattern: Browse the pattern grid at the bottom and click a pattern to preview it on the banner.
  4. Confirm Layer: Click Confirm Layer to lock the pattern into the design shown in the output slot without altering your original item yet.
  5. Build Layers: Repeat steps 3 and 4 to keep adding layers up to the server's configured maximum limit.
  6. Collect Item: Take the completed banner from the output slot when you are satisfied with the design.

Use the arrows on either side of the pattern grid to page through options, and check the info book in the middle to track how many layers you've used out of the maximum.

Duplicating a Banner

  1. Set Master Template: Place your finished, patterned banner in the template slot; it acts as a permanent master copy and is never consumed.
  2. Add Blanks: Place a blank banner of the same color in the blank slot next to it.
  3. Duplicate: Click the Duplicate Banner button to receive an exact copy, consuming one blank banner per copy.

The template banner remains in its slot continuously, allowing you to produce as many duplicates as you have blank banners to feed it.

Admin Commands

<thead> </thead> <tbody> </tbody>
Command Description
/loomlimit reload Reloads the configuration file and reports the current maximum layer count.

Configuration

Server administrators can tweak these settings inside the plugin configuration file:

<thead> </thead> <tbody> </tbody>
Setting Default What it controls
max-patterns 16 Maximum number of pattern layers a banner can possess.
gui-title Custom Loom The title text shown at the top of the loom menu interface.
patterns-per-page 27 How many patterns are displayed per page in the grid (capped at 27).

After making changes to the configuration, execute /loomlimit reload to apply updates instantly without restarting the server.