Author Topic: weapons.tbl wiki  (Read 2551 times)

0 Members and 1 Guest are viewing this topic.

Offline z64555

  • 210
  • Self-proclaimed controls expert
    • Minecraft
    • Steam
Just wanted to get a couple of opinions on how to better organize/format the weapons.tbl page. It seems to be missing info in places, not very clear in others, and I honestly don't know what to do about formatting.

(also, have there been any new weapon.tbl entries since rev. 7766?)
Secure the Source, Contain the Code, Protect the Project
chief1983

------------
funtapaz: Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Juche.
z64555: s/J/Do
BotenAlfred: <funtapaz> Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Douche.

 

Offline The E

  • He's Ebeneezer Goode
  • 213
  • Nothing personal, just tech support.
    • Steam
    • Twitter
It might be a good thing if you started out by telling us where info is missing, or where it is not very clear.
If I'm just aching this can't go on
I came from chasing dreams to feel alone
There must be changes, miss to feel strong
I really need lifе to touch me
--Evergrey, Where August Mourns

 

Offline z64555

  • 210
  • Self-proclaimed controls expert
    • Minecraft
    • Steam
Quote
Special Case Weapons
  • Requires: "beam" Flag
  • Requires: $Beaminfo

Flak Guns

 
  •   REQUIRE: "flak" and "particle spew" flags
  •   Must have inner and outer radius defined to have any effect.
  •   Does not use any model or weapon effect though model must be defined, usually Hornet.pof. Instead it uses particle spew. Trails can also be added.
What? I can see the requirements for both, but I don't see any real explanation. It seems very condensed to me and doesn't really answer the general question "How to I make a beam/flak weapon?"


Quote
General Format

Should this be a section before the "Weapons Table" format?

Quote
+nocreate

This appears to be grouped OK along with the "$Name:" entry, but there's no visible difference between it and higher grouping.

Quote
$Subtype:
FS2 Open 3.6.10:

Missing info?

Quote
  • Example: Tech_Subach_HL-7
Quote
Example

XSTR(
"''The Subach-Innes HL-7...''", 3245)
$end_multi_text

Inconsistent style.

Quote
$Damage Type:
FS2 Open 3.6.10:

 
  •    Defines the damage type that this weapon uses. All armor effects are applied after shield and have no function against shockwave or subsystem damage. REQUIRES ADDITIONAL TABLE.
  •    Syntax: String, name of the damage type as defined in armor.tbl
I'm guessing that the required table is armor.tbl?

Homing has several suboptions, but are not accessible via the main menu.


I think I'll stop here for now...
Secure the Source, Contain the Code, Protect the Project
chief1983

------------
funtapaz: Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Juche.
z64555: s/J/Do
BotenAlfred: <funtapaz> Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Douche.

 

Offline Wanderer

  • Wiki Warrior
  • Moderator
  • 211
  • Mostly harmless
Quote
What? I can see the requirements for both, but I don't see any real explanation. It seems very condensed to me and doesn't really answer the general question "How to I make a beam/flak weapon?"
Technically that is not what the weapons.tbl article is about. It is about listing and explaining the options that can be set in the table file. Tutorials as to how to make new weapons would go elsewhere.

Like http://www.hard-light.net/wiki/index.php/Tutorial_-_Beam_Weapons (old page, could or rather should be updated)

Quote
Should this be a section before the "Weapons Table" format?
'Weapons Table' could be removed, it seems to be an empty section

Quote
Quote
+nocreate
This appears to be grouped OK along with the "$Name:" entry, but there's no visible difference between it and higher grouping.
Which is related to the later issue you listed regarding why certain options are 'hidden' from the menu list.

Quote
Missing info?
I thought it was polite not to write there anything if did not know how that option could be used

Quote
Inconsistent style.
True and i think it might be better to give examples as if they had been written in table file instead of just entires. However then we get to the issue of to represent them. While < pre> text is possible it should be noted that it easily breaks things (also it does not wrap around making it rather difficult to handle), < code> is another possibility but it renders (IIRC) the background of text with black in wiki (background color), < tt> would give similar font but without undue effects, perhaps with template to render nice box around the text or something?

Quote
I'm guessing that the required table is armor.tbl?
That it is.

Quote
Homing has several suboptions, but are not accessible via the main menu.
IIRC original issue revolved around the headers of different levels, that is the difference between upper and lower level header did not seem to be clear enough. But if that is not seen a problem then they could be organized into true headers (and end up in the menu).
Do not meddle in the affairs of coders for they are soggy and hard to light

 

Offline z64555

  • 210
  • Self-proclaimed controls expert
    • Minecraft
    • Steam
I've made a few more changes to the format, as per your suggestions, as well as add some stuff to possibly make it bit easier to read through.


Quote from: Wanderer
i think it might be better to give examples as if they had been written in table file instead of just entries. However then we get to the issue of to represent them. While < pre> text is possible it should be noted that it easily breaks things (also it does not wrap around making it rather difficult to handle), < code> is another possibility but it renders (IIRC) the background of text with black in wiki (background color), < tt> would give similar font but without undue effects, perhaps with template to render nice box around the text or something?

I'm thinking the < tt> is the way to go, we'll have to find a good template for it though. Do you know the link that goes over how to make one, or where we could grab one?

Quote from: Wanderer
Quote from: z64555
Homing has several suboptions, but are not accessible via the main menu.
IIRC original issue revolved around the headers of different levels, that is the difference between upper and lower level header did not seem to be clear enough. But if that is not seen a problem then they could be organized into true headers (and end up in the menu).

The contents menu right now seems to have a clear separation between the different header levels, but inside the bulk of the wiki it's difficult to determine the individual levels based on the styles of the header bars... however, I don't think its that much of a problem, since most of the time I use the menu to jump to the entries I want to look at. :p

What may be a problem is the tables that's currently used to mark pieces that have been added since a particular version of FSO, such as 3.6.10. Currently I have the $Homing suboptions as headers, and the version note right below the header.
Secure the Source, Contain the Code, Protect the Project
chief1983

------------
funtapaz: Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Juche.
z64555: s/J/Do
BotenAlfred: <funtapaz> Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Douche.

 

Offline Wanderer

  • Wiki Warrior
  • Moderator
  • 211
  • Mostly harmless
I've made a few more changes to the format, as per your suggestions, as well as add some stuff to possibly make it bit easier to read through.
Ok.

Quote
I'm thinking the < tt> is the way to go, we'll have to find a good template for it though. Do you know the link that goes over how to make one, or where we could grab one?
Well i used sandbox to create test scenarios, i) with pre, ii) with code iii) with tt and iv) with template utilizing tt.
http://www.hard-light.net/wiki/index.php?title=Sandbox&oldid=37280
http://www.hard-light.net/wiki/index.php/Template:Example

Quote
The contents menu right now seems to have a clear separation between the different header levels, but inside the bulk of the wiki it's difficult to determine the individual levels based on the styles of the header bars... however, I don't think its that much of a problem, since most of the time I use the menu to jump to the entries I want to look at. :p

What may be a problem is the tables that's currently used to mark pieces that have been added since a particular version of FSO, such as 3.6.10. Currently I have the $Homing suboptions as headers, and the version note right below the header.
Yeah, with headers the version note should go right below the header, it seems to be the safest and cleanest way of doing things. It's not a problem.
Do not meddle in the affairs of coders for they are soggy and hard to light

 

Offline z64555

  • 210
  • Self-proclaimed controls expert
    • Minecraft
    • Steam
Well i used sandbox to create test scenarios, i) with pre, ii) with code iii) with tt and iv) with template utilizing tt.
http://www.hard-light.net/wiki/index.php?title=Sandbox&oldid=37280
http://www.hard-light.net/wiki/index.php/Template:Example

Hey, that looks nice!  :yes:
Secure the Source, Contain the Code, Protect the Project
chief1983

------------
funtapaz: Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Juche.
z64555: s/J/Do
BotenAlfred: <funtapaz> Hunchon University biologists prove mankind is evolving to new, higher form of life, known as Homopithecus Douche.