Forge
Reference

Resource descriptor

Every attribute of the generated resource descriptor XML.

A resource descriptor, such as MDR_Plugin_Macrodata Refinement_7199_descriptor.xml, declares a resource's metadata and its installation paths. CATIA Magic reads it when installing the archive. Dassault documents the format in Resource manager descriptor file.

Forge writes this file from the resource.* properties, so a project edits properties rather than XML. The Rule column below records what validateGradleProperties enforces on the corresponding property.

The descriptor itself installs under data/resourcemanager/ and is not listed in its own <installation> node.

Example

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<resourceDescriptor date="2025-11-09 17:27:16" description="The work is mysterious and important." homePage="https://github.lumon.com/macrodata-refinement" id="7199" mdVersionMax="2024x Refresh3" mdVersionMin="2024x Refresh2" name="Macrodata Refinement" restartMagicdraw="true" type="Plugin">
  <version human="8.9.27" internal="8009027" resource="80090270"/>
  <provider email="mark.s@lumon.com" homePage="https://www.lumon.com" name="Mark S"/>
  <edition>Architect</edition>
  <edition>Enterprise</edition>
  <edition>Magic Software Architect</edition>
  <edition>Magic Cyber Systems Engineer</edition>
  <edition>Magic Systems of Systems Architect</edition>
  <requiredResource id="1488" name="Product Line Engineering">
      <minVersion human="2024x Refresh2" internal="202400000"/>
  </requiredResource>
  <installation>
    <file from="modelLibraries/LumonIndustryStandard.mdzip" to="modelLibraries/LumonIndustryStandard.mdzip"/>
    <file from="plugins/com.lumon.macrodatarefinement/plugin.xml" to="plugins/com.lumon.macrodatarefinement/plugin.xml"/>
    <file from="profiles/Lumon Core Profile.mdzip" to="profiles/Lumon Core Profile.mdzip"/>
    <file from="samples/Lumon/Macrodata Refinement Sample.mdzip" to="samples/Lumon/Macrodata Refinement Sample.mdzip"/>
    <file from="templates/Lumon/Lumon Project Template.mdzip" to="templates/Lumon/Lumon Project Template.mdzip"/>
  </installation>
</resourceDescriptor>

Attributes

resourceDescriptor

NameDescriptionRule
dateBuild dateOptional
descriptionDescription of the resourceOptional
homePageURL of the resource, such as its Git repositoryURL
idUnique resource identifier, forming part of the descriptor file nameNon-negative integer
mdVersionMin, mdVersionMaxLimit which CATIA Magic installations accept the resource20{dd}x [Refresh d]
nameResource name, forming part of the descriptor file name and unique across all installed resourcesNot empty
restartMagicdrawWhether installation requires a restartBoolean
typeKind of resource, driving where the installer lists itOne of Custom Diagram, Sample, Language, Model Library, Plugin, Plugin (commercial), Profile, Template

version

NameDescriptionRule
humanVersion shown to usersPrefer semantic versioning; free text is accepted
internalVersion used for internal counting, hidden from usersPositive integer
resourceIdentifies the resource build or releasePositive integer, usually internal × 10

provider

NameDescriptionRule
emailProvider contact addressEmail, optional
homePageProvider home pageURL, optional
nameProvider nameOptional

edition

One element per supported program edition, from Reader, Community, Standard, Personal, Professional, Architect, Enterprise, Magic Software Architect, Magic Cyber Systems Engineer, Magic Systems of Systems Architect.

requiredResource

NameDescriptionRule
idIdentifier of the required resourcePositive integer
nameName of the required resourceNot empty
minVersion humanMinimum version of the required resourceAs version human above
minVersion internalInternal minimum version of the required resourcePositive integer

Forge fills these nodes from the catiaMagic dependencies a project declares, resolving them against registry.json. See Declare dependencies.

installation

One <file> element per file in the archive.

NameDescriptionRule
fromPath inside the archiveRelative path
toPath under the CATIA Magic installation rootRelative path

On this page