ADRIFT 5 newcomer advice

This forum is the place to learn about and discuss ADRIFT 5. Feel free to mention any bugs you find here, but please also add these to the Bugs & Enhancements list.

Please also refer to the ADRIFT 5 Wiki for more information.
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Updating a game on the ADRIFT site

Post by Denk »

You might have tried to upload a game to the ADRIFT site and then later you find that there are some bugs in it, so you want to replace the uploaded game with a newer version. This can be done in two ways but I think most will prefer the latter:

1. Delete the uploaded game and upload the new version as it was a new game. The disadvantages of this method are many: The number of downloads and online plays will be reset to zero and links from e.g. IFDB will have to be updated to point at this "new" game.

2. Replace the game file directly so that everything except the game file stays the same.


I think most people want option 2 but it may not be obvious how to do that. In both cases, you must be logged in, then go to the GAMES section on the ADRIFT site. Just above the first listed game, there is a link called "Upload an adventure". Then you must navigate to your game-file and upload it to the site.

Unfortunately, you don't get to choose between the two options mentioned above. Instead the ADRIFT site will determine whether the game is a new game or an existing game:

If the game has the same IFID as an existing game, the existing game will be replaced. If not, the game will be regarded as a new game.

Unfortunately, you cannot choose the IFID of your game. Whenever you start writing a new game, ADRIFT 5 will randomly choose an IFID for you. There are so many possibilities that no game will ever have the same IFID. As long as you click SAVE in the Developer to save your game, the IFID will remain unchanged. But if at some point you choose SAVE AS in the Developer to save your game under a different name, the IFID will be changed by ADRIFT. This is rather unpractical since you might just want to save your game with a new version number, e.g "mygameVersion2.taf".

So if you already have uploaded your game to the ADRIFT site and you want to fix some bugs and replace the first uploaded file, you should not use SAVE AS within the Developer to change the file you are working on, since this will change the IFID.

Instead, you should copy the file in Windows and paste it to an appropriate location. The two files will then have the same IFID. After you have done that, you can rename the file to what you like. Now you can work on the file knowing that it has the right IFID and that it will be replacing the existing file when you upload it to the ADRIFT site.

EDIT: However, if you for some reason want to update a game with a file, which has a different IFID, there is a way, as explained by Lazzah in the following post.

A final note: When you replace a game-file with the same IFID, make sure that the new game-file has a different name than the previous version, e.g. "mygameV2.taf". If they have exactly the same file name and IFID, I have experienced that the ADRIFT site keeps the old file instead of the new one, even though I am told the file was replaced! So I recommend to always use a new file name.


Table of Contents can be found here: viewtopic.php?f=14&t=12082
Last edited by Denk on Tue May 12, 2020 11:28 pm, edited 1 time in total.
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
Lazzah
Moderator
Posts: 2408
Joined: Thu Mar 31, 2011 5:54 am
Points: 65
Location: Clacton-on-Sea, Essex

Re: ADRIFT 5 newcomer advice

Post by Lazzah »

When I tried to upload a new version of my game Die Feuerfaust, I found that instead of it replacing the current version on the ADRIFT site, it uploaded as a new game as it had a different IFID number to the existing game. As you said, you cannot change the IFID number of your game, but you CAN change the IFID number of a game already on the ADRIFT site. So I deleted the newly uploaded game and changed the IFID number of the existing version of Die Feuerfaust to that of the game that I was trying to replace it with. Bingo! When I uploaded the new version it replaced the old version and I learned something new!
The Axe of Kolt, The Spectre of Castle Coris, The Fortress of Fear, Die Feuerfaust, The Lost Children, Run, Bronwynn, Run, The Call of the Shaman, The Lost Labyrinth of Lazaitch, Magnetic Moon, Starship Quest, Revenge of the Space Pirates
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Re: ADRIFT 5 newcomer advice

Post by Denk »

Wow, I didn't know that! Great, then it is always possible to replace the file, even if it the files have different IFIDs. :bravo:

Table of Contents can be found here: viewtopic.php?f=14&t=12082
Last edited by Denk on Sat Jun 06, 2020 11:04 am, edited 1 time in total.
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Fix problems when objects and characters have the same name

Post by Denk »

When objects and characters for some reason have the same name (e.g. Mr. Ladder and a ladder), there will be problems. The most important is probably when examining those objects.

Example (Mr. Ladder and a ladder):
Because the standard library task "Examine %objects%" has higher priority (thus lower priority number) than the task "Examine %character%", the standard library will always think that you want to examine the ladder if you type EXAMINE LADDER. Thus if you are in the same room as Mr. Ladder and the ladder is not in the location, you will be told that you cannot see the ladder if you try to EXAMINE LADDER. If you swap the priorities you will not be able to examine the ladder object.

There is a solution to this problem:
Make a general task with the command field identical to the "EXAMINE %character%"-task but with much higher priority (thus low priority number). It should not display any message. It should only have one restriction:
[Referenced Character][must][be same loc as character][The Player Character]
and there should be no restriction message.

It also has only one action:
[Run Task][Examine characters] (parameter is %character%)

Thus in the special case that you are in the same location as Mr. Ladder, EXAMINE LADDER means you want to examine Mr. Ladder and not the ladder.

This technique is demonstrated in the attached file below:
Obj_to_character V4.taf
(15.29 KiB) Downloaded 43 times
Table of Contents can be found here: viewtopic.php?f=14&t=12082
Last edited by Denk on Fri Jul 24, 2020 9:02 am, edited 1 time in total.
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Task Execution Logic

Post by Denk »

temp.png
temp.png (9.92 KiB) Viewed 1430 times
Under Options->Advanced you can change the Task Execution Logic. However, this is normally NOT recommended.

Here is a quote from the ADRIFT Wiki ( http://wiki.adrift.co/Options#Advanced_Tab ):
Task execution logic
ADRIFT 4 uses slightly different logic than ADRIFT 5 when choosing which tasks to execute. This option will be automatically set depending on whether this game is a converted ADRIFT 4 game or a new ADRIFT 5 game. Do not change this for ADRIFT 5 games as the standard library will not work properly.
So unless you started your game in ADRIFT 4 and at some point converted it to ADRIFT 5 (and I am not even sure whether it is a good idea then), it is recommended to use the default setting "Execute the highest priority task matching command input, whether it passes or not.".

If you have a problem which can be fixed by changing the Task Execution Logic, it can most likely be fixed in other ways too. If you change the Task Execution Logic to the unrecommended setting, your game can probably still be completed with your macros since the macros contain the "right" commands, whereas the right Restriction Messages may not be displayed.

So I can only recommend sticking to the recommended setting.

Table of Contents can be found here: viewtopic.php?f=14&t=12082
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Changing the default colors in your games

Post by Denk »

It is possible to change the default colors and fonts in your games. This is done under "options". However, the player can override these settings in the Runner under View->Options. Still, I guess most players do not change colors and fonts, unless they found them very annoying. Especially in IFComp, many of the players may not even know how to change the colors in the Runner. So You can expect most players to play with the colors you have chosen for them.

Personally, I am not very fond of the default output color of ADRIFT but some might disagree.

Before choosing colors, please be aware, that the background color is ALWAYS black when playing the game online. Thus the text colors you use in your game should be acceptable on a black background. For this reason, I always use black background.

Below is shown a part of the Options in the Developer. These are the main colors, but you can use more colors in your game than those colors.
Main Colors.png
Main Colors.png (2.51 KiB) Viewed 480 times
You can change any of these four colors by clicking on them. The purpose of these four colors are not all obvious:
* Background color: Pretty obvious - the color of the background. When playing the game online, the background color is black independent of this setting.
* Output color: The normal color used when a task sends text to the screen.
* Input color: The text typed by the player can be found here.
* Link color: This color is rarely used. It is only present when three settings are set (one setting in the Developer and two settings in the Runner):
- In Developer->Options "Enable context sensitive menu in games" must be enabled
- In Runner->view->Options select "Enable right-click menu in games"
- In Runner->view->Options select "Display links on clickable items"
--- With these settings, items such as objects, characters and directions will be shown in the link color.

Normally, there is no reason to care about the link color.

Output color is by default the selected output color, but in the output text you can easily swap between output color and input color. The input color can be used as output color in a text box by applying <c> in front of the text you want to be printed in the input color. To stop using the input color again, apply </c> after the text.

EXAMPLE:

Code: Select all

TRY TO PUT THIS CODE IN A TEXT BOX:
This is written in normal output color
<c>This is written with input color</c>
In addition to all this, within a text box you can always write text in any color (if the player allows you with the settings in the Runner).

EXAMPLES:

Code: Select all

<font color = yellow>This is yellow text</font>
or if you like hexadecimal color codes, e.g.:

Code: Select all

<font color = #01ffff>another color</font>
If you are interested in hexadecimal color codes, I am not the one to ask, but others might know more about those.

Table of Contents can be found here: http://forum.adrift.co/viewtopic.php?f=14&t=12082
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
P/o Prune
Site Admin
Posts: 4671
Joined: Mon Jun 24, 2002 9:18 am
Points: 93
Location: Denmark

Re: ADRIFT 5 newcomer advice

Post by P/o Prune »

Just a little tip regarding the text color, although I'm sure most of you know this already.
If you go to any post in the forum and click on reply, you'll get an empty box with some options up above it.
One of them is named "Font colour" Click on it and you can chose what colour you want your text to be. The smart thing is that it also gives you the HTML color code.
Choose whatever colour you fancy and just copy/paste it into your game. (Following Denk's instructions of course :wink: )
D-Day in progress 86Kb (Slowly drifting)
Just a Fairy Tale: 138Kb
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Re: ADRIFT 5 newcomer advice

Post by Denk »

P/o Prune wrote:If you go to any post in the forum and click on reply, you'll get an empty box with some options up above it.
One of them is named "Font colour" Click on it and you can chose what colour you want your text to be. The smart thing is that it also gives you the HTML color code.
Great tip! I didn't know that. :claps:
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
DazaKiwi
Posts: 774
Joined: Thu Oct 21, 2010 10:05 am
Points: 61
Location: New Zealand

Re: ADRIFT 5 newcomer advice

Post by DazaKiwi »

Lazzah wrote: Tue May 12, 2020 6:16 pm When I tried to upload a new version of my game Die Feuerfaust, I found that instead of it replacing the current version on the ADRIFT site, it uploaded as a new game as it had a different IFID number to the existing game. As you said, you cannot change the IFID number of your game, but you CAN change the IFID number of a game already on the ADRIFT site. So I deleted the newly uploaded game and changed the IFID number of the existing version of Die Feuerfaust to that of the game that I was trying to replace it with. Bingo! When I uploaded the new version it replaced the old version and I learned something new!
I don't follow. How do you change the IFID on the games page? and how is the newer version updated on the games page, as you said you deleted the newly uploaded game :?

The main thing i want is to have the review on my game page remain and total plays etc and have the lastest version of my game. I read Denk's guide, but my new build already has a different IFID.

There has to be an easier way implemented onto the website, such as an update button.
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Re: ADRIFT 5 newcomer advice

Post by Denk »

DazaKiwi wrote:

I don't follow. How do you change the IFID on the games page? and how is the newer version updated on the games page, as you said you deleted the newly uploaded game :?

The main thing i want is to have the review on my game page remain and total plays etc and have the lastest version of my game. I read Denk's guide, but my new build already has a different IFID.

There has to be an easier way implemented onto the website, such as an update button.
For now there is only this way. I can see you have uploaded V15, which might(?) complicate it. Here is what you should do in order to replace the file for V13:
1. Delete the V15 game on the ADRIFT Site.
2. Make a new blorb with a brand new IFID.
3. Click "Edit adventure details" for v13.
4. On the line "IFID" change the IFID to that brand new IFID and save changes.
5. Before uploading the new blorb, change the filename to something new, e.g. remove the underscore or call it v16.
6. Upload the new blorb. Do not change the adventure details now (later), just ok and save. If you now go to games and find your game (currently named v13 but the file-name is the one, e. g. v16) you csn see if the file was replaced. Now you can edit adventure details, e. g title to v16 etc.
If you prefer, you can have a rehearsal with a testgame replacing another testgame.
I will upload a picture in a moment.
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
Denk
Posts: 587
Joined: Mon Feb 22, 2016 6:21 pm
Points: 251
Location: Hjørring, Denmark

Re: ADRIFT 5 newcomer advice

Post by Denk »

picture to post above:
(note IFID field can be changed)
Attachments
Screenshot_20201004_071401_com.android.chrome.jpg
Screenshot_20201004_071401_com.android.chrome.jpg (453.43 KiB) Viewed 213 times
----------------------------------------------------------------------
The Bash Saga:
1. The Dragon Diamond 2. The Way Home 3. Stone of Wisdom
----------------------------------------------------------------------
User avatar
Lumin
Posts: 2188
Joined: Fri Aug 06, 2004 6:48 pm
Points: 49

Re: ADRIFT 5 newcomer advice

Post by Lumin »

I hope Denk is getting plenty of pointless points from Po for all the advice in this thread.
User avatar
P/o Prune
Site Admin
Posts: 4671
Joined: Mon Jun 24, 2002 9:18 am
Points: 93
Location: Denmark

Re: ADRIFT 5 newcomer advice

Post by P/o Prune »

Lumin wrote: Sun Oct 04, 2020 5:47 pm I hope Denk is getting plenty of pointless points from Po for all the advice in this thread.
Ohh! Lady. You have no idea :whistle:
D-Day in progress 86Kb (Slowly drifting)
Just a Fairy Tale: 138Kb
Lakanar
Posts: 26
Joined: Sun Sep 18, 2011 4:06 pm

Re: ADRIFT 5 newcomer advice

Post by Lakanar »

Here's my advice: I may have not finished a game in Adrift, but I've finished games in other programs(namely RPGMAKER). For your first project, I would keep it short and simple and not try to make a giant world-spanning adventure. In the W.I.P forum, I see plenty of giant projects that promise the moon and never get finished. Make a game you can finish.
Post Reply