Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Cog

“Grandpa sailed to the far island once. He came back with a hat and never said where he got it.” – Little Drizzik

A fast ship with six gun ports and a hold for cargo. Build it on a Shipyard’s dock. Its guns fire only with a military crew: troops sail it and man them.

A ship with a civil crew that lands on a coast away from your roads founds a settlement there.

For modders

Every number on this page comes from the building's blueprint. Blueprint specs says what each component does.

Folktails Buildings/Cog/Cog.Folktails.blueprint.json

BuildingSpec

{
  "SelectionSoundName": "TE.SailSnap",
  "LoopingSoundName": "",
  "BuildingCost": [
    {
      "Id": "Log",
      "Amount": 40
    },
    {
      "Id": "Plank",
      "Amount": 30
    },
    {
      "Id": "Gear",
      "Amount": 8
    },
    {
      "Id": "MetalBlock",
      "Amount": 6
    }
  ],
  "ScienceCost": 1200,
  "PlaceFinished": false,
  "FinishableWithBeaversOnSite": true,
  "DrawRangeBoundsOnIt": false
}

TemplateSpec

{
  "TemplateName": "Cog.Folktails",
  "BackwardCompatibleTemplateNames": [
    "Sloop.Folktails"
  ],
  "RequiredFeatureToggle": "",
  "DisablingFeatureToggle": ""
}

BlockObjectSpec

{
  "Size": {
    "X": 3,
    "Y": 7,
    "Z": 3
  }
}

PlaceableBlockObjectSpec

{
  "ToolGroupId": "TimberEmpiresSiege",
  "ToolOrder": 49,
  "ToolShape": "Square",
  "Layout": "Single",
  "CustomPivot": {
    "HasCustomPivot": false,
    "Coordinates": {
      "X": 0,
      "Y": 0,
      "Z": 0
    }
  },
  "CanBeAttachedToTerrainSide": false,
  "DevModeTool": false
}

ConstructionSiteBuildTimeSpec

{
  "ConstructionTimeInHours": 24
}

ShipCrewModeSpec

Lets a ship's crew be civil (workers sail it) or military (troops aboard sail it and fire its guns). It can only be switched while the ship is ashore.

Military
Starts the ship with a military crew. Default false.
{
  "Military": false
}

ShipHoldSpec

Gives a ship a hold that haulers load and unload like a warehouse, and that slows the ship as it fills.

Slots
How many kinds of goods it can be set to load at once. Default 5.
Capacity
The most it holds, all goods together. Default 100.
LoadedSpeed
The share of its speed it keeps with the hold full, less loaded in between. Default 0.6.
LoadedTurn
The share of its turning it keeps with the hold full. Default 0.4.
{
  "Slots": 5,
  "Capacity": 240
}

StructureHealthSpec

Gives the building health that attacks wear down. Walls, gates, towers and siege engines get theirs from the troop stats file, other buildings by size.

Machine
Marks it as a machine troops ride (a boat) rather than something built to keep them out. Default false.
{
  "Machine": true
}

WarBoatSpec

Makes a ship (a template with a BoatSpec) a war boat that takes troops aboard and fights. Its speed, crew, health and gun reach come from the troop stats file.

{}

WarriorCrewSpec

Lets troops ride inside the building and work it. A siege engine or boat needs its crew aboard.

CrewAnimation
The animation the crew plays at their posts, one every beaver has.
BoardsOverBow
Troops board from the shore it's against, bow first, instead of from behind. For a boat on a beach. Default false.
{
  "CrewAnimation": "",
  "BoardsOverBow": true
}

ShipArmamentSpec

Gives a ship gun ports where cannons can be mounted.

Ports
The gun ports, as a list of {"Side", "Position"}. Side is -1 for the side towards X = 0 and 1 for the other. Position is the port's middle in the model's frame.
PortArc
How far round the ports let a gun turn, as a share of the gun's own arc. Default 1. Round ports in an iron hull hold it close, so use less; guns on an open deck swing freely.
Hull
Where the hull lies in its footprint, as {X, Y, Width, Length}, in tiles with Y counted from the bow. The panel uses it to place the ports over the deck drawing.
DeckSprite
The deck drawing the panel puts the ports over, bow to the left. Left out, it's Sprites/TimberEmpires/Ships/TemplateNameDeck.
{
  "Hull": {
    "X": 0.275,
    "Y": 0.2,
    "Width": 2.45,
    "Length": 6.6
  },
  "Ports": [
    {
      "Side": 1,
      "Position": {
        "X": 2.757,
        "Y": 1.114,
        "Z": 2.956
      }
    },
    {
      "Side": 1,
      "Position": {
        "X": 2.757,
        "Y": 1.114,
        "Z": 3.64
      }
    },
    {
      "Side": 1,
      "Position": {
        "X": 2.757,
        "Y": 1.114,
        "Z": 4.323
      }
    },
    {
      "Side": -1,
      "Position": {
        "X": 0.243,
        "Y": 1.114,
        "Z": 2.956
      }
    },
    {
      "Side": -1,
      "Position": {
        "X": 0.243,
        "Y": 1.114,
        "Z": 3.64
      }
    },
    {
      "Side": -1,
      "Position": {
        "X": 0.243,
        "Y": 1.114,
        "Z": 4.323
      }
    }
  ]
}

WorkplaceSpec

{
  "MaxWorkers": 2,
  "DefaultWorkers": 2,
  "DefaultWorkerType": "Beaver",
  "DisallowOtherWorkerTypes": true,
  "WorkerTypeUnlockCosts": []
}

ShipDeckSpec

{
  "Spots": [
    {
      "X": 1.84,
      "Y": 0.99,
      "Z": 4.69
    },
    {
      "X": 1.5,
      "Y": 1.26,
      "Z": 1.86
    },
    {
      "X": 1.5,
      "Y": 1.1,
      "Z": 6
    }
  ],
  "Facing": 180,
  "Yaws": [
    145,
    230,
    290
  ]
}

Stats line in Troops/TroopStats.blueprint.json

{
  "Name": "Cog",
  "Health": 220,
  "TilesPerHour": 45,
  "WindTilesPerHour": 60,
  "CrewCapacity": 6,
  "MinCrew": 1,
  "MaxRange": 9,
  "ReloadHours": 0.5,
  "Damage": 4,
  "TurnDegreesPerHour": 360,
  "WindTurnDegreesPerHour": 480
}

Iron Teeth Buildings/Cog/Cog.IronTeeth.blueprint.json

BuildingSpec

{
  "SelectionSoundName": "TE.SailSnap",
  "LoopingSoundName": "",
  "BuildingCost": [
    {
      "Id": "Log",
      "Amount": 40
    },
    {
      "Id": "Plank",
      "Amount": 30
    },
    {
      "Id": "Gear",
      "Amount": 8
    },
    {
      "Id": "MetalBlock",
      "Amount": 6
    }
  ],
  "ScienceCost": 1200,
  "PlaceFinished": false,
  "FinishableWithBeaversOnSite": true,
  "DrawRangeBoundsOnIt": false
}

TemplateSpec

{
  "TemplateName": "Cog.IronTeeth",
  "BackwardCompatibleTemplateNames": [],
  "RequiredFeatureToggle": "",
  "DisablingFeatureToggle": ""
}

BlockObjectSpec

{
  "Size": {
    "X": 3,
    "Y": 7,
    "Z": 3
  }
}

PlaceableBlockObjectSpec

{
  "ToolGroupId": "TimberEmpiresSiege",
  "ToolOrder": 49,
  "ToolShape": "Square",
  "Layout": "Single",
  "CustomPivot": {
    "HasCustomPivot": false,
    "Coordinates": {
      "X": 0,
      "Y": 0,
      "Z": 0
    }
  },
  "CanBeAttachedToTerrainSide": false,
  "DevModeTool": false
}

ConstructionSiteBuildTimeSpec

{
  "ConstructionTimeInHours": 24
}

ShipCrewModeSpec

Lets a ship's crew be civil (workers sail it) or military (troops aboard sail it and fire its guns). It can only be switched while the ship is ashore.

Military
Starts the ship with a military crew. Default false.
{
  "Military": false
}

ShipHoldSpec

Gives a ship a hold that haulers load and unload like a warehouse, and that slows the ship as it fills.

Slots
How many kinds of goods it can be set to load at once. Default 5.
Capacity
The most it holds, all goods together. Default 100.
LoadedSpeed
The share of its speed it keeps with the hold full, less loaded in between. Default 0.6.
LoadedTurn
The share of its turning it keeps with the hold full. Default 0.4.
{
  "Slots": 5,
  "Capacity": 240
}

StructureHealthSpec

Gives the building health that attacks wear down. Walls, gates, towers and siege engines get theirs from the troop stats file, other buildings by size.

Machine
Marks it as a machine troops ride (a boat) rather than something built to keep them out. Default false.
{
  "Machine": true
}

WarBoatSpec

Makes a ship (a template with a BoatSpec) a war boat that takes troops aboard and fights. Its speed, crew, health and gun reach come from the troop stats file.

{}

WarriorCrewSpec

Lets troops ride inside the building and work it. A siege engine or boat needs its crew aboard.

CrewAnimation
The animation the crew plays at their posts, one every beaver has.
BoardsOverBow
Troops board from the shore it's against, bow first, instead of from behind. For a boat on a beach. Default false.
{
  "CrewAnimation": "",
  "BoardsOverBow": true
}

ShipArmamentSpec

Gives a ship gun ports where cannons can be mounted.

Ports
The gun ports, as a list of {"Side", "Position"}. Side is -1 for the side towards X = 0 and 1 for the other. Position is the port's middle in the model's frame.
PortArc
How far round the ports let a gun turn, as a share of the gun's own arc. Default 1. Round ports in an iron hull hold it close, so use less; guns on an open deck swing freely.
Hull
Where the hull lies in its footprint, as {X, Y, Width, Length}, in tiles with Y counted from the bow. The panel uses it to place the ports over the deck drawing.
DeckSprite
The deck drawing the panel puts the ports over, bow to the left. Left out, it's Sprites/TimberEmpires/Ships/TemplateNameDeck.
{
  "Hull": {
    "X": 0.275,
    "Y": 0.2,
    "Width": 2.45,
    "Length": 6.6
  },
  "Ports": [
    {
      "Side": 1,
      "Position": {
        "X": 2.757,
        "Y": 1.114,
        "Z": 2.956
      }
    },
    {
      "Side": 1,
      "Position": {
        "X": 2.757,
        "Y": 1.114,
        "Z": 3.64
      }
    },
    {
      "Side": 1,
      "Position": {
        "X": 2.757,
        "Y": 1.114,
        "Z": 4.323
      }
    },
    {
      "Side": -1,
      "Position": {
        "X": 0.243,
        "Y": 1.114,
        "Z": 2.956
      }
    },
    {
      "Side": -1,
      "Position": {
        "X": 0.243,
        "Y": 1.114,
        "Z": 3.64
      }
    },
    {
      "Side": -1,
      "Position": {
        "X": 0.243,
        "Y": 1.114,
        "Z": 4.323
      }
    }
  ]
}

WorkplaceSpec

{
  "MaxWorkers": 2,
  "DefaultWorkers": 2,
  "DefaultWorkerType": "Beaver",
  "DisallowOtherWorkerTypes": true,
  "WorkerTypeUnlockCosts": []
}

ShipDeckSpec

{
  "Spots": [
    {
      "X": 1.84,
      "Y": 0.99,
      "Z": 4.69
    },
    {
      "X": 1.5,
      "Y": 1.26,
      "Z": 1.86
    },
    {
      "X": 1.5,
      "Y": 1.1,
      "Z": 6
    }
  ],
  "Facing": 180,
  "Yaws": [
    145,
    230,
    290
  ]
}

Stats line in Troops/TroopStats.blueprint.json

{
  "Name": "Cog",
  "Health": 220,
  "TilesPerHour": 45,
  "WindTilesPerHour": 60,
  "CrewCapacity": 6,
  "MinCrew": 1,
  "MaxRange": 9,
  "ReloadHours": 0.5,
  "Damage": 4,
  "TurnDegreesPerHour": 360,
  "WindTurnDegreesPerHour": 480
}