Transport Tycoon Forums

Cadde wrote:the link goes to the bottom of the page.

• The GRF header. (https://newgrf-specs.tt-wiki.net/wiki/N ... parameters)

  Code: Select all

  grf {
      grfid: "ABC\01";
      name: string(STR_GRF_NAME);
      desc: string(STR_GRF_DESCRIPTION);
      version: 1;
      min_compatible_version: 0;
  }

  • grfid - The unique 4 character identifier of your GRF. No different from the NFO equivalent. (https://newgrf-specs.tt-wiki.net/wiki/Action8#GRFID)
  • name - The text that's supposed to be shown in the newgrf settings window. As well as in some other irrelevant places. The "string(...)" statement here refers to an entry in a language file. (https://newgrf-specs.tt-wiki.net/wiki/N ... uage_files)
  • desc - The description as shown in the information panel when you select the grf in the newgrf settings window. Again, using the "string(...)" statement from before.
  • version - The GRF file version. Letting the game know which file to use if there's duplicates etc. Or just letting the user see which version he's using and thusly being able to report issues with that version rather than just guessing.
  • min_compatible_version - The version of OTTD that this GRF file is compatible against. And so should be beyond. As grf specs have changed in ottd versions past, your grf may be using features that didn't exist before that specific version. Technically speaking, you should set the number to the current OTTD revision you've been testing against.
• The sprites.

  Code: Select all

  spriteset (spriteset_tram_Le_Tram_Mk1, "gfx/Le_Tram_Mk1.png")
  {
    [0, 0, 16, 16, 0, -3]
  }
  
  spriteset (spriteset_tram_Le_Tram_Mk1_purchase, "gfx/Le_Tram_Mk1.png")
  {
    [0, 17, 16, 16, 0, -3]
  }

  spritesets are something i haven't bothered learning about myself yet. You can read about them here: https://newgrf-specs.tt-wiki.net/wiki/NML:Spriteset
  I would recommend using templates, you can find out more in the link. Templates are another powerful feature of NML that NFO does not provide.
• The item(s)

  Code: Select all

  item(FEAT_ROADVEHS, item_tram_Le_Tram_Mk1) {
      property {
          name:                   string(STR_LE_TRAM_MK1);
          misc_flags;             bitmask(ROADVEH_FLAG_TRAM, ROADVEH_FLAG_2CC);
          introduction_date:      date(1935,1,1);
          model_life:             35;
          vehicle_life:           15;
          cost_factor:            25;
          running_cost_factor:    22;
          speed:                  32 km/h;
          power:                  15 hp;
          cargo_capacity:         20;
          weight:                 10 ton;
          sprite_id:              SPRITE_ID_NEW_ROADVEH;
      ... etc
      }
      graphics {
          purchase: spriteset_tram_Le_Tram_Mk1_purchase;
          spriteset_tram_Le_Tram_Mk1;
      }
  }

  • misc_flags - The one you were asking about. Setting this to a bitmask like above is the same as setting it = 3 in NFO (Bit 0 and Bit 1 set)
  • graphics block - This can be used to define callbacks, the "complicated ones" are out of the scope of this quick guide.
    You have already defined the sprite sets earlier. Here you declare which sprites the vehicle will use.
    purchase - The sprite to be used for purchase.
    The default callback is the sprite of the vehicle in the world.
  • OTHERS - I refer you to the documentation: https://newgrf-specs.tt-wiki.net/wiki/N ... properties
  As you can see, the properties are the same as they are in NFO, they just carry names instead of hexadecimal id's. Thus making it much easier to see what's what and what is being assigned.
• Fine tuning and possible callbacks etc. (totally optional)

grf {
    grfid: "ABC\01";
    name: string(STR_GRF_NAME);
    desc: string(STR_GRF_DESCRIPTION);
    version: 1;
    min_compatible_version: 0;
}
graphics {
    purchase: spriteset_tram_Le_Tram_Mk1_purchase;
    spriteset_tram_Le_Tram_Mk1;
}

spriteset (spriteset_tram_Le_Tram_Mk1, "gfx/Le_Tram_Mk1.png")
{
  [0, 0, 16, 16, 0, -3]
}

spriteset (spriteset_tram_Le_Tram_Mk1_purchase, "gfx/Le_Tram_Mk1.png")
{
  [0, 17, 16, 16, 0, -3]
}

item(FEAT_ROADVEHS, item_tram_Le_Tram_Mk1) {
    property {
        name:                   string(STR_LE_TRAM_MK1);
        misc_flags;             bitmask(ROADVEH_FLAG_TRAM, ROADVEH_FLAG_2CC);
        introduction_date:      date(1935,1,1);
        model_life:             35;
        vehicle_life:           15;
        cost_factor:            25;
        running_cost_factor:    22;
        speed:                  32 km/h;
        power:                  15 hp;
        cargo_capacity:         20;
        weight:                 10 ton;
        sprite_id:              SPRITE_ID_NEW_ROADVEH;
    ... etc
    }
    graphics {
        purchase: spriteset_tram_Le_Tram_Mk1_purchase;
        spriteset_tram_Le_Tram_Mk1;
    }
}

##grflangid 0x01
# This is the English language file

# GRF name and description definitions
STR_GRF_NAME        :Le tram (v0.01)
STR_GRF_DESCRIPTION :Le super awesome Le Tram Mk1 from Le internets.

STR_LE_TRAM_MK1     :Le Tram 'Baguette' Mk. 1

ir1n1o57 wrote:I downloaded newgrf source from the internet, but how can i edit it with M4NFO?