Flyff Universe API (1.2.1)

Download OpenAPI specification:Download

Sniegu Technologies: flyff@sniegu.fr URL: https://www.sniegu.fr

Welcome to Flyff Universe Public API!

The API is still in development and specifications can change as well as the main URL.

Check Flyff Official Fansite Kit for high-quality 2D assets.

Contact the developers by mail or on the official Discord if you have questions, suggestions, or a bug to report.

Copyright 2021-2022 © Gala Lab Corp. All Rights Reserved.

Permission to use the data and images granted only for information sites and tools about the official game. Gala Lab reserves the right to no longer grant this permission at any time. Commercial use strictly prohibited. Use for in-game automation and cheating tools, or use in any other video game is strictly prohibited. Please contact the developers if you wish to verify that your use of this API is in accordance with the copyright.


Gala Lab Logo

Introduction

Currently limited to 300 calls per minute per IP. No size limitation on the request and the response.

Feel free to cache the results and fetch the data only when the data version changes.

Version History:

  • 1.0.0 - 2021/03/17 - Initial version. Class, NPC and Place basic information.
  • 1.1.0 - 2021/07/19 - World, Monster, Item, Skill, Element and Language. Added more Class and Place icons.
  • 1.1.1 - 2021/08/01 - Monster experience and bug fixes.
  • 1.1.2 - 2021/09/06 - Karma levels, Boss Monsters spawns and more Monster Attack information.
  • 1.2.0 - 2021/11/03 - Party Skill, Quest and Achievement.
  • 1.2.1 - 2022/05/03 - Upgrade level bonus and bug fixes.

Version

Get the version of the game data

Returns an unique ID representing the current version of the static game data

Responses

Response samples

Content type
application/json
1

Get the version of the game API

Returns the current version of the game API

Responses

Response samples

Content type
application/json
"1.2.0"

Class

id
required
integer

ID of the class

name
required
object (LocalizedText)

Text available in several languages

type
required
string
Enum: "beginner" "expert" "professional"

Type of the class

icon
required
string

Icon of the Class

minLevel
required
integer

Minimum player level for the Class

maxLevel
required
integer

Maximum player level for the Class

parent
integer

ID of the parent class

maxHP
required
string

Formula to compute the maximum Hit Points of the player

maxFP
required
string

Formula to compute the maximum Fatigue Points of the player

maxMP
required
string

Formula to compute the maximum Mana Points of the player

{
  • "id": 9686,
  • "name": {
    },
  • "type": "beginner",
  • "icon": "vagrant.png",
  • "minLevel": 1,
  • "maxLevel": 15,
  • "parent": 764,
  • "maxHP": "150+level*18+sta*level*0.18",
  • "maxFP": "level*0.6+sta*2.1",
  • "maxMP": "22+level*0.6+int*2.7"
}

Get all classes IDs

Returns an array containing the ID of all available classes

Responses

Response samples

Content type
application/json
[
  • 1689,
  • 296,
  • 2881
]

Find class by ID

Returns a single class

path Parameters
classId
required
integer
Example: 1689

ID of class to return

Responses

Response samples

Content type
application/json
{
  • "id": 9686,
  • "name": {
    },
  • "type": "beginner",
  • "icon": "vagrant.png",
  • "minLevel": 1,
  • "maxLevel": 15,
  • "parent": 764,
  • "maxHP": "150+level*18+sta*level*0.18",
  • "maxFP": "level*0.6+sta*2.1",
  • "maxMP": "22+level*0.6+int*2.7"
}

Find classes by a list of IDs

Returns an array with classes

path Parameters
classIds
required
any
Example: 1689,296,2881

IDs of classes to return separated by comma ,

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get class icon

Returns icon for the specified file name

path Parameters
style
required
any
Example: messenger

Style of the icon. Accepted values: messenger, old_female, old_male, target.

fileName
required
any
Example: vagrant.png

File name of the icon

Responses

World

id
required
integer

ID of the World

name
required
object (LocalizedText)

Text available in several languages

type
required
string
Enum: "main" "prison" "dungeon" "instance" "event"

Type of the World

width
required
integer

Width of the World in meters

height
required
integer

Height of the World in meters

tileName
required
string

Name of the world Tiles for navigator

tileSize
required
integer

World meters per Tile

flying
required
boolean

Whether players can fly in the World or not

pk
required
boolean

Whether players can kill other players in the World or not

inDoor
required
boolean

Whether the World has a sky or not

revivalWorld
integer

ID of the World where players revive when they die in the World

revivalKey
string

ID of the Lodestar where players revive when they die in the World

required
Array of objects[ items ]

Special Places in the World

required
Array of objects[ items ]

Revival places in the World

required
Array of objects[ items ]

Continents in the World

{
  • "id": 6063,
  • "name": {
    },
  • "type": "dungeon",
  • "width": 10752,
  • "height": 5632,
  • "tileName": "wdmadrigal",
  • "tileSize": 512,
  • "flying": true,
  • "pk": true,
  • "inDoor": false,
  • "revivalWorld": 6063,
  • "revivalKey": "flaris",
  • "places": [
    ],
  • "lodestars": [
    ],
  • "continents": [
    ]
}

Get all worlds IDs

Returns an array containing the ID of all available worlds

Responses

Response samples

Content type
application/json
[
  • 4015,
  • 4839,
  • 6063
]

Find world by ID

Returns a single world

path Parameters
worldId
required
integer
Example: 4015

ID of world to return

Responses

Response samples

Content type
application/json
{
  • "id": 6063,
  • "name": {
    },
  • "type": "dungeon",
  • "width": 10752,
  • "height": 5632,
  • "tileName": "wdmadrigal",
  • "tileSize": 512,
  • "flying": true,
  • "pk": true,
  • "inDoor": false,
  • "revivalWorld": 6063,
  • "revivalKey": "flaris",
  • "places": [
    ],
  • "lodestars": [
    ],
  • "continents": [
    ]
}

Find worlds by a list of IDs

Returns an array with worlds

path Parameters
worldIds
required
any
Example: 4015,4839,6063

IDs of worlds to return separated by comma ,

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get world tile

Returns tile for the specified world and position

path Parameters
worldTileName
required
any
Example: wdmadrigal

Tile name of the world

tileX
required
any

X position of the tile

tileY
required
any

Y position of the tile

Responses

Monster

id
required
integer

ID of the Monster

name
required
object (LocalizedText)

Text available in several languages

level
required
integer

Level of the Monster

rank
required
string
Enum: "small" "normal" "captain" "giant" "violet" "boss" "material" "super" "guard"

Rank of the Monster

area
required
string
Enum: "normal" "dungeon"

Type of area where the Monster spawns

element
required
string (Element)
Enum: "fire" "water" "electricity" "wind" "earth" "none"

Natural element

icon
required
string

Icon of the Monster

booty
integer

ID of the booty Item dropped by the Monster

mineral
integer

ID of the mineral Item collected on the Catcher Monster

flying
required
boolean

Whether the Monster is flying or not

hp
required
integer

Hit Points of the Monster

mp
required
integer

Mana Points of the Monster

minAttack
required
integer

Minimum Attack of the Monster

maxAttack
required
integer

Maximum Attack of the Monster

defense
required
integer

Defense of the Monster

magicDefense
required
integer

Magic Defense of the Monster

sta
required
integer

Stamina of the Monster

str
required
integer

Strength of the Monster

dex
required
integer

Dexterity of the Monster

int
required
integer

Intelligence of the Monster

hitRate
required
integer

Ability of the Monster to inflict a successful hit to its target

parry
required
integer

Ability of the Monster to receive a Miss from its attacker. This value is equivalent to lowering the attacker's hitRate

runaway
required
boolean

Whether the Monster can run away when its Hit Points are low or not

summoned
required
Array of integers[ items ]

List of Monsters which can be summoned by the Monster

berserkThresholdHP
integer

Threshold in % of Hit Points to activate the Monster's berserk mode

berserkAttackPower
integer

Attack Power bonus in % when Monster's berserk mode is active

recoveryThresholdHP
integer

Threshold in % of Hit Points to recover the Monster's Hit Points