Four inventory purposes
Printable designs are files, not existing miniatures. They limit merchant generation and cannot be assigned, supply physical OpFor or earn a discount. A design is reusable; buying one unit does not consume the file.
Printed unpainted models are physical stock for the smaller merchant-purchase discount and the GM painting queue. They are not normal OpFor, manual player-model choices, salvage discounts or starting-grant discounts. A merchant purchase records its printed allocation automatically.
Painted models outside all configured player company schemes supply normal OpFor. Player schemes are excluded from that pool, even while their painted copies are free. The separate explicit GM exception for a pre-existing force using outside models remains an override, not automatically eligible inventory.
Painted models in a company scheme represent its units. Free copies supply the largest configured miniature discount on purchases or salvage; assignments and explicit reservations reduce free quantity. Missing assignments do not reserve stock. Saving Destroyed releases the model to the supply.
Release assignments and pending reservations before changing physical stock into printable designs or removing allocated quantity. Inventory changes preserve paid purchase receipts.
Contract, mission opposition and unit choices
Open Operations → Build OpFor and select an unreported mission. Budget allocations creates allowances; Mission opposition saves the force to face; Fill budgets randomly selects its RATs from the remaining pools; Search / add units finds variants by name; Enter existing unit records a pre-existing force. Saved opposing force lists and edits saved units. Players cannot access OpFor pages.
The default opposition comes from the mission’s linked shared contract, including Later opposition after its saved change date. A mission-specific faction choice overrides this default without altering the contract. Existing saved enemies are preserved.
The scheduled date determines the exact year. Imported RAT records and any known introduction years filter the results; the catalog is limited to imported RAT coverage, so review scenario-specific eligibility.
Only free painted physical models outside every configured player scheme are eligible for automatic filling and search. Variants share chassis capacity. Published cached costs fill where available; manual entries require GM-reviewed final BV/PV.
Your GM inventory library
Open Account → My inventories. Each GM has a private library; other GMs and players cannot view, export or edit it. Administrators do not gain access to another GM’s library through these pages.
Choose Create inventory type and enter any name, such as Unpainted units, Unpainted 3D printed units or 3D printable units. Availability is Painted physical models, Unpainted physical models or Printable designs. Only nonplayer-scheme painted stock counts toward normal OpFor; company-scheme painted stock supplies player model discounts. Unpainted physical models supply the already printed discount on merchant purchases only, when free company-color painted stock is unavailable. Purchased printed allocations appear on the GM painting list. Salvage rounds reserve one physical model per awarded discounted purchase. Printable designs do not represent models already made.
Open an inventory to Add record, Edit record, Edit inventory type, Import / refresh, Export CSV or view History. Every record is editable, including imported records: model name, unit type, chassis match, quantity, faction, unit/paint style, weight label and role. Set quantity to zero to retire stock. For an entry created in error, choose Delete entry beside its row or from its edit page. Review the named entry and quantity, check the confirmation box, then choose Delete entry. Deletion removes current availability from linked campaigns, retains the previous entry in revision history and audit, and does not alter saved forces, company equipment or finances. Imported entries can return on refresh if still present in the source; correct the source too. Save other pending grid edits before opening the delete page. Unrecognized names are highlighted and provide no OpFor capacity until matched through the chassis dropdown.
On the inventory records page, combine Model name, Minimum/Maximum quantity, Faction, Paint style, Chassis and Review status filters. Results update automatically as you type or choose a value. Each dropdown lists only values compatible with the other active filters, across the whole inventory, including unspecified faction/style. An active selection remains available to clear even when no records match. Apply filters also refreshes results. New and unsaved rows stay visible and retain their edits; counts describe saved matching records. Quantity bounds include their endpoints; enter the same minimum and maximum for an exact quantity. Review status can show unmatched chassis, local edits, changed sources or any warning. Clear filters resets the list. Counts and total quantity cover all matching records; paging retains the filters. Export CSV still exports the full inventory.
Unpainted physical models and printable designs use a Tech base selector (Inner Sphere, Clan or Mixed) instead of painting faction and style. Existing paint-style data is retained. CSV compatibility keeps tech base in the Faction column for unpainted stock and printable designs.
Inventory tonnage bands for Meks and vehicles are Light below 40, Medium from 40 to below 60 (normally 40?55), Heavy from 60 to below 80 (normally 60?75), and Assault at 80 or more tons. Battle Armor and Infantry have no weight category; saving edited rows of these types clears the weight label. Aerospace fighter and Aerospace craft are separate inventory choices and do not contaminate Mek results. Aerospace tonnages currently use the same inventory display bands.
Typing a model name first searches the imported Local MekLab cache and filters by unit type. When several BattleMech families match, choose a family suggestion beneath Model before saving; the dropdown lists each family once. Only that family supplies weight, roles and tech base. Mixed variants, or both Inner Sphere and Clan variants, yield Mixed. Review matching units shows variants and relative source files. IndustrialMechs, support vehicles and ProtoMechs stay separate from BattleMech/vehicle searches. Local file coverage is not complete live MUL coverage. If no local matches exist, the app uses its existing MUL search and cached fallback. HTTP 403 means that MUL rejected the server request even if your browser can open it. Missing source roles remain missing; no values are invented. Changing name/type restarts lookup. Saving waits for lookup and any required family choice. Choosing a family replaces generated weight/role/tech fields; painted faction/style stays unchanged.
The lookup shows a source link and whether results are cached. No matches for the selected type, unavailable metadata, blocked requests and incomplete search/role coverage are highlighted. Fields remain editable; no roles are invented. Servers require PHP cURL for live retrieval and DOM support for parsing. Cached reference data supplements prior searches; cache-only results explicitly warn that full live coverage is unverified. A search page that requires browser JavaScript cannot be read by the server lookup.
Edit inventory cells directly and use Tab to move between cells. Add row inserts a row at the top. In painted inventories, Faction and Paint style default to the most recently added row, including unsaved values. Saving remembers those defaults for the next visit and for Add record. You can override them or leave them blank; active filters do not replace these remembered values. Unpainted and printable inventories continue to obtain tech base from unit lookups. Add several rows, then Save changes to save all changed rows together. Saving is atomic; validation failures keep your unsaved edits on screen. The toolbar shows unsaved rows and warns before leaving the inventory. Filtering and inventory paging preserve unsaved rows. Save before leaving the inventory. Up to 50 new rows can be added per save. New rows inherit the unit type from the most recently added row; after saving, the inventory remembers that type for the next visit.
Model, type, quantity, faction, paint style, weight class and role can be edited in the grid. Changing model or unit type clears a previous manual chassis match and retries automatic matching. Use Details / chassis match for manual mapping and reviewing source changes. Existing imported source evidence, review warnings and revision history are preserved. If another window changes the inventory, saving is rejected; keep a copy of your edits and reload to reconcile. New rows remain visible while editing but are subject to active filters after saving.
Download CSV template from My inventories or Import inventory. Fill columns A–G: Faction, Unit, Model Type, Model Name, Weight Class, Role, Qty. The example has quantity zero; replace it with your records. Model Type supports Mek, Vehicle, VTOL, Infantry, Battle Armor, Aerospace fighter and Aerospace craft. Legacy Mek-only sheets may omit Model Type. Qty counts playable units, not individual infantry figures.
Import into the selected inventory type using a CSV upload or up to ten publicly readable Google Sheets tab links. Only A–G are read. Limits: 2 MB per source, 5000 rows per inventory, quantity 0–10000. Model names allow 200 characters, Faction and Unit 150, Weight Class 100 and Role 500. Live Google Sheets retrieval requires PHP cURL and valid HTTPS certificate trust.
Refreshing the same sheet or CSV filename updates its unedited rows rather than appending duplicate stock. Local edits survive refresh, including edited rows removed from the source. Changed source values are highlighted; Edit record shows the latest source and offers Keep these values and mark the latest source reviewed. Keeping a locally edited row that disappeared from its source makes it manual. Different filenames represent different sources. Renamed source model/style identities are new rows, so review source-change warnings before using refreshed quantities.
Full previous inventory snapshots and original source evidence are retained by revision. Stale forms are rejected instead of overwriting a newer edit. Edits update every linked campaign’s current availability but do not rewrite saved OpFor, player-owned units or finances.
Use inventories in campaigns and review discounts
Open Campaign → Miniature inventory. The campaign GM owner selects inventories from their own library and chooses whether to limit OpFor. The same library inventory can be selected in several campaigns. Printable designs are never counted as physical models. Do not select multiple copied inventories representing the same physical stock.
Database updates migrate each previous campaign inventory into its GM owner’s library, retain its original campaign link, and archive the original snapshot. Separate campaign copies remain separate for review; the upgrade does not guess whether similar inventories represent the same models. It does not change balances or owned units.
OpFor excludes every painted model whose faction / paint style is allocated to any player company, including unused models. From the remaining painted stock it subtracts individual company model reservations. Unpainted stock and printable designs are excluded. Variants share one chassis allowance; Griffin IIC remains distinct from Griffin. Unowned and exhausted chassis cannot be drawn. Random generation reports any unspent budget. Saved OpFor uses models within that mission; other missions and campaigns do not reserve them globally.
On Campaign inventory settings, assign each company a paint style from selected painted inventories. Save newly selected inventories before choosing their styles. To remove an inventory supplying a company’s style, choose No player paint style or a replacement. A saved style that disappears after library edits is highlighted for correction.
Merchant and salvage discounts count saved physical assignments and explicit reservations only. Unresolved owned units are review tasks and do not infer holds on free stock. Pending salvage purchases reserve stock across reports. Painted discounts require the selected company scheme. Only merchant purchases can fall back to eligible printed unpainted stock; salvage, refits and starting grants cannot.
Viewing merchant prices does not reserve stock. Purchasing does: the app assigns an available model with the company equipment and SP charge. GM model-record corrections also reserve physical quantities. Salvage priority rounds reserve models for awarded purchases and assign them when finalization posts the purchase. Configure percentages under Campaign > Salvage rules.
Add missing unit values to your cache
Manual miniature metadata can describe a missing model or chassis even when external lookup is unavailable. It cannot create combat values: import the exact MTF/BLK design to calculate current BV/PV.
Enter the model name/type, common chassis, tech base and applicable roles. Tonnage describes the miniature metadata; current design combat values and construction tonnage come from the imported source. Manual metadata BV/PV entries cannot override the engine.
Save manual cache entry, return to the original inventory tab and choose Retry lookup. Save the inventory row separately. Manual entries belong to your GM account and can be reused across your inventories; they do not create models, change quantities or spend funds. Reopening the same name/type lets you edit your existing entry. Changes are audited and protected against stale submissions.
Cache matches and lookup warnings
Roles are the unique available roles across matching variants of the selected chassis and unit type. Variants without a recorded role are ignored; they do not make the combined role result incomplete.
A matching local or cached unit is a successful lookup. Available weight, tech base and roles fill the row; missing variant details or an unavailable live MUL search are informational and do not mark the lookup as an error.
Manual cache entry is offered when a lookup fails or cannot supply a weight class (where applicable), tech base or any role data. You can also use Add a manual cache unit above the inventory filters.
A red inventory row can separately mean its saved chassis is unmatched or its import source changed. Review the message below Role; finding metadata does not by itself resolve the inventory chassis relationship.
A successful type-filtered cache lookup fills available weight, roles and tech base and clears the stale unmatched-row outline. Save changes persists the reviewed cache match and links a recognized chassis. Unsaved changes remain marked; genuine import-source conflicts still require review.
Cached records missing from the chassis catalog can still be saved without a lookup error. Details / chassis match identifies any separate mapping needed for painted OpFor capacity or miniature discount checks. A cache match does not invent physical inventory or verified BV/PV. Manual field overrides remain editable.
Choose an inventory family
Family selection applies to every inventory unit type, including Vehicle / VTOL. The lookup filters by unit type first, then uses the cached family names to group variants.
When several families match, choose a family suggestion beneath Model before saving. Searching Scorpion as Vehicle / VTOL offers Desert Scorpion Light Tank and Scorpion Light Tank separately. Choosing a family updates the model name and fills weight, combined known roles and tech base using only that family. Mixed is used when its variants include both Inner Sphere and Clan or a Mixed entry.
Changing the name or type clears the previous family selection and starts a fresh lookup. Save changes retains the selected name and validated cache match. Infantry and Battle Armor still have no weight class.
Complete individual variant cache records
Expand Review matching units and choose Edit cache record beside the exact variant. Each link opens a new tab and preserves your unsaved inventory row.
The editor prefills known values for that exact variant, including chassis family, tonnage and tech base. It does not copy a sibling variant’s role. Look up this variant on MUL opens its search in another tab; you can use another reference when MUL is unavailable.
Fill missing details and record your source, then Save manual cache entry. This updates your GM-owned override, preserving imported source data and other GMs’ records. Return to the inventory tab, choose Refresh cache matches, select a family again if prompted, and Save changes separately. Existing personal entries take precedence when reopening the editor.
Model autocomplete
Type at least two characters in Model. Matching families appear directly beneath the field, filtered by the selected unit type. A single family is offered too: Harr can be completed to Harrier Heavy Hover Tank.
Click a suggestion, or use Up/Down and Enter. Escape closes suggestions. Selection completes the name and fills the chosen family’s available metadata. Partial names and ambiguous families require a selection before saving.
Changing the unit type or typed name discards outdated suggestions. Existing exact variant names remain editable; cache editing links and Refresh cache matches remain available.
Automatic acquisition models and GM corrections
Merchant purchases, salvage and starting equipment automatically select and save eligible models at acquisition. Company Information > Model status is read-only for players. A unit keeps its exact variant while its physical model represents the matching chassis family.
Models awaiting printing or painting appear on the GM Models to prepare list. A deliberate outside-model exception is separate from an acquisition waiting for a physical model. Existing printed allocations remain painting tasks and cannot be selected as finished painted models.
Only the campaign GM can use Correct this model record for a specific saved unit. Corrections check paint scheme, chassis, free quantity and reservations and retain audit history. They do not recalculate completed purchase discounts or charge/refund SP. Destroyed units return their physical model to supply automatically when saved.
Import an unprinted 3D design collection
Create an inventory under My inventories with mode Printable designs (not physical stock), then open its Import inventory page and upload the chassis CSV. Qty 1 means one available reusable design entry, not one printed miniature.
The first seven CSV columns use the usual inventory headings. An optional eighth Chassis ID column preserves reviewed exact chassis mappings. Blank mappings remain available for review in Details. Existing locally reviewed mappings survive re-imports.
Select this inventory under Campaign > Miniature inventory so Veteran Command and merchant generation can find the designs. Printable entries never supply OpFor physical stock or painted/printed discounts.
The companion source and variant CSVs are reference files, not inventory imports. A cached variant can be represented by its chassis; only variants explicitly marked as named in files have filename evidence for that exact sculpt. Check campaign year and faction separately.
Confirm a selected cache match
Selecting a cache family fills its metadata and explicitly links a known inventory chassis, even when its free-text aliases are ambiguous. The old chassis warning changes to Match selected - save changes to confirm. This is pending until Save changes succeeds.
Changing Model or Unit type discards that pending selection and restores any saved chassis warning. Choose the family again before saving. Import-source warnings remain separate and still require review.
If only cache metadata is found and no inventory chassis can be identified, the chassis warning remains. Use Details / chassis match to select the correct inventory chassis. Metadata alone does not supply model availability.
After uploading v169, run Admin > Database updates to repair earlier saved cache selections missing their chassis link. The repair preserves explicit matches, quantities, model assignments and financial records, saves revision history and is safe to rerun.
One Battle Armor or Infantry miniature, several unit types
Open My inventories, select the painted, unpainted or printable collection, then Details / compatible units beside the record. Choose Battle Armor or Infantry. Under Units this miniature can represent, search and check every suitable family. Save record. You can keep a descriptive model name such as Generic rifle platoon; the checked families supply its compatibility.
There is no 200-family cap: select any suitable families of the chosen unit type. If a save fails, your selected families remain checked so you can correct the reported problem and save again.
A rifle platoon can represent ballistic and laser infantry; a missile platoon can represent SRM and LRM infantry. Battle Armor models can represent several selected armor families. Only recognized variants within selected families match; compatibility is explicit, not all infantry or armor automatically. Meks retain their existing single chassis-family match.
Quantity is shared, not multiplied by the number of selections. One painted squad or platoon can supply one opposing unit or one company model assignment at a time. OpFor checks the whole force, rebalancing overlapping model choices when possible, and cannot consume a shared model twice. Player-reserved paint schemes remain excluded.
Printed and painted stock also share their quantities across all compatible types for assignments and discounts. For merchant purchases, company-color painted stock takes precedence, then spare printed unpainted stock. Salvage and manual assignment use company-color painted stock only. Printable designs remain reusable and give no physical-model discount. Choosing more compatible types does not change a unit design, BV, PV, technology or era eligibility.
Selected families stay visible while searching. The inventory Chassis filter finds every selected family. Ordinary row edits and source refreshes retain your reviewed compatibility; a cache choice can add a family without discarding existing alternatives. Removing compatibility used by an assigned company unit requires releasing or reassigning that model first.
CSV export includes Chassis ID and Compatible Chassis IDs. The latter holds the selected Battle Armor or Infantry IDs separated by |. Import preserves these relationships in one row; do not duplicate rows for each alternative, since that would create extra stock. Older seven- and eight-column CSV files remain supported.
For single-family models, Chassis match lists only families of the selected Unit type. Changing Unit type refreshes the list and clears an incompatible chassis choice. Select a matching chassis or leave Automatic match / unresolved.
Chassis choices include imported MekLab families even when absent from random assignment tables, including videogame/apocryphal designs. Exact variants and model codes connect to those families. Ambiguous names still need an explicit chassis choice. Finding a design does not establish faction availability, verified BV/PV or physical miniature stock; those checks remain separate. IndustrialMechs, ProtoMechs and support vehicles are not silently converted to other inventory categories.
Automatic salvage and merchant miniature discounts use physical collections selected in Campaign inventory settings, not every collection in My inventories. Select your unpainted collection too. Existing equipment and pending purchases reserve stock. When salvage offers no model discount, the GM sees an explanation and a link to campaign inventories.