Friday Facts #294 - Blog thoughts & Lua documentation improvements

Regular reports on Factorio development.

User avatar
Gergely
Filter Inserter
Filter Inserter
Posts: 607
Joined: Sun Apr 10, 2016 8:31 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by Gergely »

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?

User avatar
ThaPear
Fast Inserter
Fast Inserter
Posts: 226
Joined: Fri May 30, 2014 8:05 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by ThaPear »

It's nice to see that not everyone zones out when there's no shiny new feature in the FFF for a few weeks!

User avatar
Maldor96
Burner Inserter
Burner Inserter
Posts: 17
Joined: Tue May 09, 2017 8:53 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by Maldor96 »

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.
Like this week as well?
Always a pleasure to read the facts every week, starts the weekend the right way every time. I've enjoyed reading about the...
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.
Loved the game and loved what you do. Keep building a great game and great people will come!
More Cracktorio!
Addicted to cracktorio since May 2017
Streaming live at: https://www.twitch.tv/maldor96

User avatar
QGamer
Fast Inserter
Fast Inserter
Posts: 214
Joined: Fri Apr 14, 2017 9:27 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by QGamer »

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?
"Adam fell that men might be; and men are, that they might have joy."

Jonathan88
Fast Inserter
Fast Inserter
Posts: 180
Joined: Tue Jan 20, 2015 7:49 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by Jonathan88 »

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

Bilka
Factorio Staff
Factorio Staff
Posts: 3248
Joined: Sat Aug 13, 2016 9:20 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by Bilka »

QGamer wrote: ↑
Fri May 10, 2019 4:59 pm
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?
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.

User avatar
steinio
Smart Inserter
Smart Inserter
Posts: 2638
Joined: Sat Mar 12, 2016 4:19 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by steinio »

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.
Image

Transport Belt Repair Man

View unread Posts

User avatar
dog80
Filter Inserter
Filter Inserter
Posts: 286
Joined: Thu Dec 08, 2016 11:57 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by dog80 »

yes please lua documentation improvements plzzzzzzz

fendy3002
Burner Inserter
Burner Inserter
Posts: 18
Joined: Fri Jul 13, 2018 3:19 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by fendy3002 »

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.

User avatar
eradicator
Smart Inserter
Smart Inserter
Posts: 5206
Joined: Tue Jul 12, 2016 9:03 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by eradicator »

'Meta-posts' about the company and the changes outside of the game.
And transcended meta posts about the nature of meta posts :p.
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.

Slackie
Inserter
Inserter
Posts: 24
Joined: Mon Mar 20, 2017 10:29 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by Slackie »

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.
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.

danielbrauer
Long Handed Inserter
Long Handed Inserter
Posts: 94
Joined: Thu May 18, 2017 2:22 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by danielbrauer »

Slackie wrote: ↑
Fri May 10, 2019 5:25 pm
Having a bit of trouble completely parsing this.
"Lua API Documentation" is a link to the documentation he's referencing:

https://lua-api.factorio.com/

User avatar
eradicator
Smart Inserter
Smart Inserter
Posts: 5206
Joined: Tue Jul 12, 2016 9:03 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by eradicator »

Slackie wrote: ↑
Fri May 10, 2019 5:25 pm
What pages are you talking about?
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 
Just this week i noticed that in 0.17.x, Case 4 of that table has grown an extra on_load, which caused me quite some headache because my on_load was trying to access global data before on_config had a chance to update the data to the format that on_load was expecting. I do not understand why on_load is raised at all if on_config is coming afterwards, because it's much easier to manually call it in on_config according to what one needs. My for-now solution is to add a __version tag to global data and force on_load to bail out if it doesn't like the version.
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.

Bilka
Factorio Staff
Factorio Staff
Posts: 3248
Joined: Sat Aug 13, 2016 9:20 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by Bilka »

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.

User avatar
y.petremann
Filter Inserter
Filter Inserter
Posts: 410
Joined: Mon Mar 17, 2014 4:24 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by y.petremann »

What is Factorio lacking about his Documentation is proper Prototype Documentation ... Would be great to have one

Bilka
Factorio Staff
Factorio Staff
Posts: 3248
Joined: Sat Aug 13, 2016 9:20 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by Bilka »

y.petremann wrote: ↑
Fri May 10, 2019 6:08 pm
What is Factorio lacking about his Documentation is proper Prototype Documentation ... Would be great to have one
https://wiki.factorio.com/Prototype_definitions is up to date and nearly complete.
I'm an admin over at https://wiki.factorio.com. Feel free to contact me if there's anything wrong (or right) with it.

User avatar
eradicator
Smart Inserter
Smart Inserter
Posts: 5206
Joined: Tue Jul 12, 2016 9:03 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by eradicator »

Bilka wrote: ↑
Fri May 10, 2019 6:05 pm
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
I was in the thread when that change happend. Though i do not remember if it happend *because* of me :twisted:.
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.

gghf
Inserter
Inserter
Posts: 34
Joined: Fri Jan 13, 2017 2:57 pm
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by gghf »

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?

nastyslave
Inserter
Inserter
Posts: 40
Joined: Sat Aug 06, 2016 11:48 am
Contact:

Re: Friday Facts #294 - Blog thoughts & Lua documentation improvements

Post by nastyslave »

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!

Post Reply

Return to β€œNews”