Friday Facts #294 - Blog thoughts & Lua documentation improvements
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
I feel like this is the best place to put a suggestion.
How about a console command to enable the research queue without disabling achievements?
How about a console command to enable the research queue without disabling achievements?
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
It's nice to see that not everyone zones out when there's no shiny new feature in the FFF for a few weeks!
My mods: Red Alert Harvesters - Clean Pipes - Filtered Splitters
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
Like this week as well?Friday Factorio Facts wrote: Other times, such as when most of the team is on bugfixing, we can take the oppourtunity to explore other points of discussion, such as the marketing post last week.
Always a pleasure to read the facts every week, starts the weekend the right way every time. I've enjoyed reading about the...
Loved the game and loved what you do. Keep building a great game and great people will come!Friday Factorio Facts wrote:
- Communicating our progress and roadmap of the next releases.
- Showing new features and gathering community feedback on them.
- Diving into the technical side of game development and particular challenges we face.
- 'Meta-posts' about the company and the changes outside of the game.
- Community spotlights and interesting Factorio related news.
More Cracktorio!
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
About the API Documentation: sometimes it's not obvious what a variable or value does just by looking at the name, and not all of them have descriptions.
Would you please consider adding a little more info to the documentation about what these variables are used for, what their default values are, and how they are represented ingame?
Would you please consider adding a little more info to the documentation about what these variables are used for, what their default values are, and how they are represented ingame?
"Adam fell that men might be; and men are, that they might have joy."
-
- Fast Inserter
- Posts: 180
- Joined: Tue Jan 20, 2015 7:49 pm
- Contact:
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
The FFF is my favourite read of the week, no matter what it's about. Don't worry so much about weeks where you feel like you've haven't got as much to show, we appreciate them all!
FactoriOh No: when it's accidentally 2am, again
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
Just tell me what specifically is lacking descriptions and I will expand the documentation of those variables.
I'm an admin over at https://wiki.factorio.com. Feel free to contact me if there's anything wrong (or right) with it.
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
I must say Factorio has the best documented API in the games department.
Had a glimpse at the Giants Developement Network which provide the Farming Simulator API docs and got a headache.
Had a glimpse at the Giants Developement Network which provide the Farming Simulator API docs and got a headache.
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
yes please lua documentation improvements plzzzzzzz
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
For me, FFF is a form of communication from devs to players. It makes me understand what kind of challenges you face for some improvement and / or balancing, and show how much care the devs got for their game. Forum discussion for each post also amp'ed the benefits.
Other than as a good form of marketing, it's also a good form for keeping track of your past works.
Other than as a good form of marketing, it's also a good form for keeping track of your past works.
- eradicator
- Smart Inserter
- Posts: 5206
- Joined: Tue Jul 12, 2016 9:03 am
- Contact:
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
And transcended meta posts about the nature of meta posts :p.'Meta-posts' about the company and the changes outside of the game.
Haven't missed a single one since quite some time ago. Though i prefer the ones with pictures ;).
Author of: Belt Planner, Hand Crank Generator, Screenshot Maker, /sudo and more.
Mod support languages: ζ₯ζ¬θͺ, Deutsch, English
My code in the post above is dedicated to the public domain under CC0.
Mod support languages: ζ₯ζ¬θͺ, Deutsch, English
My code in the post above is dedicated to the public domain under CC0.
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
Having a bit of trouble completely parsing this. What pages are you talking about? The Factorio website? The wiki? I looked around both and didn't see any API links. Might be useful to clarify what you mean by "main page" and where these new links are.The Lua API documentation is one of the most valuable resources for modders: It is generated directly from the game's source code, so it completely covers all scripting functionalities. Furthermore, additional pages cover some general concepts such as in what order mod files are loaded or how to store persistent data. However, a big issue with these pages was that they were linked at the very bottom of the main page, below two long lists of classes and events. This means that they were very easy to miss.
To remedy this, all additional pages are now linked at the top of the main page and accompanied by a short description of the structure of the API. To further support getting a quick overview, I added a page about general Lua libraries that Factorio changes. These changes could be frustrating traps where it would take users a very long time to find out that some functions, such as getting the current real time, were not available. The new main page organization should serve well to highlight this new page to make the discovery of these changes much easier.
-
- Long Handed Inserter
- Posts: 94
- Joined: Thu May 18, 2017 2:22 pm
- Contact:
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
"Lua API Documentation" is a link to the documentation he's referencing:
https://lua-api.factorio.com/
- eradicator
- Smart Inserter
- Posts: 5206
- Joined: Tue Jul 12, 2016 9:03 am
- Contact:
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
Looks like https://lua-api.factorio.com/latest/
@Bilka:
Ever since i've started caring about events, i've had to regularly look at my experimentally-deduced event order tables, because i can never quite wrap my head around why this happens (requires monospace font...), and the information in Data Lifecycle is too spread out (and possibly incomplete?) on the matter.
Code: Select all
Available apis:
INIT : remote commands settings rcon rendering script game
LOAD : remote commands settings rcon script
CONFIG : remote commands settings rcon rendering script game
Code: Select all
Base game order:
1 InstallMod -> StartMap : on_init - -
2 InstallMod -> StartMap -> SaveMap -> LoadMap: - on_load -
3 InstallMod -> StartMap -> ChangeMod -> LoadMap: - on_load on_config
4 StartMap -> SaveMap -> InstallMod -> LoadMap: on_init on_load on_config
Author of: Belt Planner, Hand Crank Generator, Screenshot Maker, /sudo and more.
Mod support languages: ζ₯ζ¬θͺ, Deutsch, English
My code in the post above is dedicated to the public domain under CC0.
Mod support languages: ζ₯ζ¬θͺ, Deutsch, English
My code in the post above is dedicated to the public domain under CC0.
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
Thanks for the feedback eradicator. Updating the doc with "rendering" being unavailable in on_load is pretty straight-forward, but I will have to think about how to document the event order for a bit. Another interesting thing concerning event order is that no events are raised for your mod before on_init runs for you, even if those events do happen (e.g. another mod creates a surface in on_init and runs before your mod).
I'm an admin over at https://wiki.factorio.com. Feel free to contact me if there's anything wrong (or right) with it.
- y.petremann
- Filter Inserter
- Posts: 410
- Joined: Mon Mar 17, 2014 4:24 pm
- Contact:
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
What is Factorio lacking about his Documentation is proper Prototype Documentation ... Would be great to have one
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
https://wiki.factorio.com/Prototype_definitions is up to date and nearly complete.y.petremann wrote: βFri May 10, 2019 6:08 pmWhat is Factorio lacking about his Documentation is proper Prototype Documentation ... Would be great to have one
I'm an admin over at https://wiki.factorio.com. Feel free to contact me if there's anything wrong (or right) with it.
- eradicator
- Smart Inserter
- Posts: 5206
- Joined: Tue Jul 12, 2016 9:03 am
- Contact:
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
I was in the thread when that change happend. Though i do not remember if it happend *because* of me .
RSO had a bug related to that the other day.
Author of: Belt Planner, Hand Crank Generator, Screenshot Maker, /sudo and more.
Mod support languages: ζ₯ζ¬θͺ, Deutsch, English
My code in the post above is dedicated to the public domain under CC0.
Mod support languages: ζ₯ζ¬θͺ, Deutsch, English
My code in the post above is dedicated to the public domain under CC0.
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
I remember the devs saying in a video years ago, that you didn't really want to keep releasing content for Factorio after 1.0, or at least not for very long. And neither did you intend to make a sequel, or something along those lines. I'm not sure if I remember correctly, but basically, you decided that 1.0 was to be your end goal.
Is this still how you feel? If no, do you already have any actual plans you might share with us?
Is this still how you feel? If no, do you already have any actual plans you might share with us?
-
- Inserter
- Posts: 40
- Joined: Sat Aug 06, 2016 11:48 am
- Contact:
Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements
Hello devs!
Also get us full information and description of \config\config.ini file. Especially I mean those settings that can't be changed from ingame menu. Like "check-for-unused-pixels=" and others. We need expanded description.
Best regards!
Also get us full information and description of \config\config.ini file. Especially I mean those settings that can't be changed from ingame menu. Like "check-for-unused-pixels=" and others. We need expanded description.
Best regards!