Prototype/Achievement: Difference between revisions

Latest revision as of 09:27, 16 August 2023

The prototype docs have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/prototypes/AchievementPrototype.html

This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.

Prototype definitions » PrototypeBase » Prototype/Achievement

This prototype definition is used for the in-game achievements.

Prototype/Achievement — `achievement`
icons, icon, icon_size (IconSpecification)	::	IconSpecification
allowed_without_fight	::	bool (optional)
hidden	::	bool (optional)
steam_stats_name	::	string (optional)
Inherited from PrototypeBase
name	::	string
type	::	string
localised_description	::	LocalisedString (optional)
localised_name	::	LocalisedString (optional)
order	::	Order (optional)

Extensions

Prototype/BuildEntityAchievement build-entity-achievement
Prototype/CombatRobotCountAchievement combat-robot-count
Prototype/ConstructWithRobotsAchievement construct-with-robots-achievement
Prototype/DeconstructWithRobotsAchievement deconstruct-with-robots-achievement
Prototype/DeliverByRobotsAchievement deliver-by-robots-achievement
Prototype/DontBuildEntityAchievement dont-build-entity-achievement
Prototype/DontCraftManuallyAchievement dont-craft-manually-achievement
Prototype/DontUseEntityInEnergyProductionAchievement dont-use-entity-in-energy-production-achievement
Prototype/FinishTheGameAchievement finish-the-game-achievement
Prototype/GroupAttackAchievement group-attack-achievement
Prototype/KillAchievement kill-achievement
Prototype/PlayerDamagedAchievement player-damaged-achievement
Prototype/ProduceAchievement produce-achievement
Prototype/ProducePerHourAchievement produce-per-hour-achievement
Prototype/ResearchAchievement research-achievement
Prototype/TrainPathAchievement train-path-achievement

Mandatory properties

Inherits all properties from PrototypeBase.

icons, icon, icon_size (IconSpecification)

Type: IconSpecification

Optional properties

steam_stats_name

Type: string
Default: ""
Unusable by mods, as this refers to unlocking the achievement through Steam.

allowed_without_fight

Type: bool
Default: true
If this is set to false, it is not possible to complete the achievement on the peaceful difficulty setting or when the enemy base generation settings have been changed.

hidden

Type: bool
Default: false

Example

{
    type = "achievement",
    name = "so-long-and-thanks-for-all-the-fish",
    order = "g[secret]-a[so-long-and-thanks-for-all-the-fish]",
    icon = "__base__/graphics/achievement/so-long-and-thanks-for-all-the-fish.png",
    icon_size = 128
  }

@@ Line 1: / Line 1: @@
-==Basics==
+'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/prototypes/AchievementPrototype.html https://lua-api.factorio.com/latest/prototypes/AchievementPrototype.html]
-This Prototype Definition is used for the in-game achievements.
-==Extensions==
+This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].
+{{Prototype parent|PrototypeBase}}
+This prototype definition is used for the in-game achievements.
+{{Prototype TOC|achievement}}
+== Extensions ==
 *[[Prototype/BuildEntityAchievement]] '''build-entity-achievement'''
-*[[Prototype/CombatRobotCount]] '''combat-robot-count'''
+*[[Prototype/CombatRobotCountAchievement]] '''combat-robot-count'''
 *[[Prototype/ConstructWithRobotsAchievement]] '''construct-with-robots-achievement'''
 *[[Prototype/DeconstructWithRobotsAchievement]] '''deconstruct-with-robots-achievement'''
@@ Line 18: / Line 27: @@
 *[[Prototype/ResearchAchievement]] '''research-achievement'''
 *[[Prototype/TrainPathAchievement]] '''train-path-achievement'''
-==Mandatory Properties==
+== Mandatory properties ==
-Inherits all properties from [[Prototype]].
+Inherits all properties from [[PrototypeBase]].
-=== icons, icon,  icon_size (IconSpecification) ===
-'''Type''': [[Types/IconSpecification]]
-===steam_stats_name===
+{{Prototype property|icons, icon, icon_size (IconSpecification) |[[Types/IconSpecification|IconSpecification]]}}
-'''Type''': [[Types/string]]
+== Optional properties ==
+{{Prototype property|steam_stats_name|[[Types/string|string]]|""|optional=true}}
 Unusable by mods, as this refers to unlocking the achievement through Steam.
-==General Optional Properties==
+{{Prototype property|allowed_without_fight |[[Types/bool|bool]]|true|optional=true}}
-'''Note''': more achievement-specific types will be in their respective Prototype page.
+If this is set to false, it is not possible to complete the achievement on the peaceful difficulty setting or when the enemy base generation settings have been changed.
-===until_second===
-'''Type''': [[Types/unsigned]]
-This lets the game know how long into a game, before you can no longer complete the achievement.
-  until_second = 60 * 60 * 8, --8 hours. 60 being seconds, 60 being hours, and 8 being the amount of hours.
-===allowed_in_peaceful_mode===
-'''Type''': [[Types/bool]]
-If this is set to false, you cannot complete the achievement on the peaceful difficulty setting.
-  allowed_in_peaceful_mode = true,
-===limited_to_one_game===
-'''Type''': [[Types/bool]]
-If this is false, the player carries over their statistics from this achievement, through all their saves.
-  limited_to_one_game = false,
+{{Prototype property|hidden |[[Types/bool|bool]]|false|optional=true}}
-==Example==
+== Example ==
-   {
+   <syntaxhighlight lang="lua">{
-     type = "kill-achievement", --This is for the achievement "[[achievements|steamrolled]]".
+     type = "achievement",
-     name = "steamrolled",
+     name = "so-long-and-thanks-for-all-the-fish",
-     order = "e[kill]-a[steamrolled]",
+     order = "g[secret]-a[so-long-and-thanks-for-all-the-fish]",
-    type_to_kill = "unit-spawner",
+     icon = "__base__/graphics/achievement/so-long-and-thanks-for-all-the-fish.png",
-    damage_type = "impact",
+    icon_size = 128
-    in_vehicle = true,
+   }</syntaxhighlight>
-    personally = true,
-    amount = 10,
-    steam_stats_name = "spawners-killed-by-impact",
-     icon = "__base__/graphics/achievement/steamrolled.png"
-   },