cpp
/
crown-engine
mirror of https://github.com/crownengine/crown.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214
							<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

    <meta property="article:modified_time" content="2026-02-18T13:11:11+00:00" /><meta property="og:title" content="Introduction" />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://docs.crownengine.org/html/latest/units/introduction.html" />
<meta property="og:site_name" content="Crown 0.60.0 Manual" />
<meta property="og:description" content="Units: Units are the basic building block in Crown. A Unit represents a single logical object in the game world: a character, a light, a prop, and so on. A unit imported from a scene, a camera unit, and a unit representing a sprite., At the most fundamental level, Units are ju..." />
<meta property="og:image" content="https://docs.crownengine.org/html/latest/_images/units.png" />
<meta property="og:image:alt" content="Crown 0.60.0 Manual" />
<meta name="description" content="Units: Units are the basic building block in Crown. A Unit represents a single logical object in the game world: a character, a light, a prop, and so on. A unit imported from a scene, a camera unit, and a unit representing a sprite., At the most fundamental level, Units are ju..." />

  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Introduction &mdash; Crown 0.60.0 Manual 0.62.0 documentation</title>
      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
      <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
    <link rel="shortcut icon" href="../_static/org.crownengine.Crown.svg"/>
    <link rel="canonical" href="https://docs.crownengine.org/html/latest/units/introduction.html" />
  <!--[if lt IE 9]>
    <script src="../_static/js/html5shiv.min.js"></script>
  <![endif]-->
  
        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
        <script src="../_static/jquery.js"></script>
        <script src="../_static/underscore.js"></script>
        <script src="../_static/doctools.js"></script>
    <script src="../_static/js/theme.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="copyright" title="Copyright" href="../copyright.html" />
    <link rel="next" title="Creating Units" href="creating_units.html" />
    <link rel="prev" title="Units" href="index.html" /> 
</head>

<body class="wy-body-for-nav"> 
  <div class="wy-grid-for-nav">
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
            <a href="../index.html">
            <img src="../_static/org.crownengine.Crown.svg" class="logo" alt="Logo"/>
          </a>
              <div class="version">
                Crown 0.60.0 Manual
              </div>
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>
        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
<li class="toctree-l1"><a class="reference internal" href="../introduction.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../installing_crown/index.html">Installing Crown</a></li>
<li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="../level_editor/index.html">Level Editor</a></li>
<li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Units</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">Introduction</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#units">Units</a></li>
<li class="toctree-l3"><a class="reference internal" href="#components">Components</a></li>
<li class="toctree-l3"><a class="reference internal" href="#hierarchies">Hierarchies</a></li>
<li class="toctree-l3"><a class="reference internal" href="#prefabs">Prefabs</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="creating_units.html">Creating Units</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../rendering/index.html">Rendering</a></li>
<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
<li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
<li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../lua_api.html">Lua API reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
<li class="toctree-l1"><a class="reference internal" href="../copyright.html">License</a></li>
<li class="toctree-l1"><a class="reference internal" href="../hackers/index.html">Engine Hackers</a></li>
</ul>

        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../index.html">Crown 0.60.0 Manual</a>
      </nav>

      <div class="wy-nav-content">
        <div class="rst-content">
          <div role="navigation" aria-label="Page navigation">
  <ul class="wy-breadcrumbs">
      <li><a href="../index.html" class="icon icon-home"></a> &raquo;</li>
          <li><a href="index.html">Units</a> &raquo;</li>
      <li>Introduction</li>
      <li class="wy-breadcrumbs-aside">
            <a href="../_sources/units/introduction.rst.txt" rel="nofollow"> View page source</a>
      </li>
  </ul>
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
             
  <section id="introduction">
<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h1>
<section id="units">
<h2>Units<a class="headerlink" href="#units" title="Permalink to this headline">¶</a></h2>
<p>Units are the basic building block in Crown. A Unit represents a single
logical object in the game world: a character, a light, a prop, and so on.</p>
<figure class="align-center" id="id1">
<img alt="../_images/units.png" src="../_images/units.png" />
<figcaption>
<p><span class="caption-text">A unit imported from a scene, a camera unit, and a unit representing a sprite.</span><a class="headerlink" href="#id1" title="Permalink to this image">¶</a></p>
</figcaption>
</figure>
<p>At the most fundamental level, Units are just numeric IDs that identify a
specific object in a World. Units on their own are empty. You add Components
to a Unit to give it behaviour and appearance.</p>
</section>
<section id="components">
<h2>Components<a class="headerlink" href="#components" title="Permalink to this headline">¶</a></h2>
<p>Contrary to some other engines, in Crown all Unit Components are optional,
even the Transform Component can be omitted. This way you can have purely
functional Units with no runtime cost.</p>
<figure class="align-center" id="id2">
<img alt="../_images/components.png" src="../_images/components.png" />
<figcaption>
<p><span class="caption-text">A “light” unit with its transform component displayed in the Inspector.</span><a class="headerlink" href="#id2" title="Permalink to this image">¶</a></p>
</figcaption>
</figure>
<p>Units can have any number of components attached to them, but only one
component per type is allowed.</p>
</section>
<section id="hierarchies">
<h2>Hierarchies<a class="headerlink" href="#hierarchies" title="Permalink to this headline">¶</a></h2>
<p>Units can be organised in parent/child hierarchies. This allows the creation
of complex units from a number of simpler ones. To create a Unit with two
lights, for example, you will create separate units each with their own Light
Component, and then link the two together via a Transform Component.</p>
</section>
<section id="prefabs">
<h2>Prefabs<a class="headerlink" href="#prefabs" title="Permalink to this headline">¶</a></h2>
<p>A unit saved in the Project as <code class="docutils literal notranslate"><span class="pre">.unit</span></code> resource is called Prefab. Prefabs
are a powerful way to reuse units. Prefabs can store not just a single unit,
but entire hierarchies with all their components and properties.</p>
<p>A prefab inherits all units and components of its base prefab, if any.
Inherited units and components in the derived prefab can be removed,
overridden, or complemented with new units and components.</p>
<p>Modifications to a base prefab are automatically propagated to all derived
prefabs.</p>
<p>The prebab system can be used to implement many popular patterns and
techniques. The most common use for a prefab is to leverage its inheritance
system to implement OOP-style behavior; you could have:</p>
<ul class="simple">
<li><p>a base <code class="docutils literal notranslate"><span class="pre">enemy</span></code> prefab that defines the common geometry, animations and
scripts;</p></li>
<li><p>derived prefabs such as <code class="docutils literal notranslate"><span class="pre">enemy_heavy</span></code> and <code class="docutils literal notranslate"><span class="pre">enemy_fast</span></code> that override
only materials, health values or behaviour parameters.</p></li>
</ul>
</section>
</section>


           </div>
          </div>
          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
        <a href="index.html" class="btn btn-neutral float-left" title="Units" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="creating_units.html" class="btn btn-neutral float-right" title="Creating Units" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
    </div>

  <hr/>

  <div role="contentinfo">
    <p>&#169; <a href="../copyright.html">Copyright</a> Except where otherwise noted, content on this page is licensed under a CC-BY-SA 4.0 Int. License.
      <span class="lastupdated">Last updated on Feb 18, 2026.
      </span></p>
  </div>

  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
    provided by <a href="https://readthedocs.org">Read the Docs</a>.
   

</footer>
        </div>
      </div>
    </section>
  </div>
  <script>
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>
    <!-- Theme Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XNVGCMNDZH"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-XNVGCMNDZH', {
          'anonymize_ip': true,
      });
    </script> 

</body>
</html>