Pangya

https://docs.pangya.golf
Admin
Pangya is an anime-style multiplayer online casual golf game developed by Ntreev Soft featuring...
Tokens:7,636
Snippets:140
Trust Score:4.4
Update:1 month ago
Show doc for...
Tokens:
Raw
### TALK File Example

Source: https://docs.pangya.golf/pc/file-formats/talk.md

Example entry from cadie.talk showing an event trigger for wind conditions.

```text
turbulence5:4:This is some serious turbulence.
```

--------------------------------

### Perform a documentation query via HTTP GET

Source: https://docs.pangya.golf/llms.txt

Use the ask parameter for specific questions and the optional goal parameter to provide context for the query.

```http
GET https://docs.pangya.golf/psp/file-formats/qst.md?ask=<question>&goal=<end_goal>
```

--------------------------------

### Example MOT file content

Source: https://docs.pangya.golf/pc/file-formats/mot.md

Typical structure of a MOT file showing numeric values mapped to Korean event strings.

```text
2:달리기    // Running
1:기다리기  // Waiting
1:재촉하기  // Prompting
0:홀인원    // Hole-in-One
0:홀인     // Hole-In
0:실격     // Disqualification
0:찬스     // Chance
```

--------------------------------

### GET /documentation-index

Source: https://docs.pangya.golf/llms.txt

Performs a natural language query against the documentation index to retrieve answers and relevant sources.

```APIDOC
## GET https://docs.pangya.golf/psp/file-formats/qst.md

### Description
Perform a natural language query against the documentation index to receive a direct answer along with relevant excerpts and sources.

### Method
GET

### Endpoint
https://docs.pangya.golf/psp/file-formats/qst.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the response.

### Request Example
GET https://docs.pangya.golf/psp/file-formats/qst.md?ask=How+do+I+parse+QST+files?&goal=Modding+Pangya
```

--------------------------------

### UpdateList XML Structure

Source: https://docs.pangya.golf/pc/file-formats/updatelist.md

Example of the decrypted XML structure used in UpdateList files. Note that this format contains multiple root nodes and is not standard XML.

```markup
<?xml version="1.0" encoding="euc-kr" standalone="yes" ?>
<patchVer value="GB.R7.852.00" />
<patchNum value="306" />
<updatelistVer value="20090331" />
<updatefiles count="2">
    <fileinfo fname="binkawin.asi" fdir="\mss" fsize="56320" fcrc="-13704566" fdate="2013-10-22" ftime="07:41:57" pname="binkawin.asi.zip" psize="32364" />
    <fileinfo fname="mssdolby.flt" fdir="\mss" fsize="7680" fcrc="-33883344" fdate="2013-10-22" ftime="07:41:56" pname="mssdolby.flt.zip" psize="2998" />
</updatefiles>
```

--------------------------------

### Define goto command

Source: https://docs.pangya.golf/pc/file-formats/seq/reference.md

Jumps to a specified label name at the given timestamp.

```text
4600: goto = loop_a
```

--------------------------------

### Set Initial Size

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the initial size range and ratio.

```text
Init_Size = (1.45, 1.45), 1
```

--------------------------------

### Define Puppet Source

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Configures a puppet source with lighting settings.

```text
Source = *pet gp_blackhole-purple02.pet, petlight
```

--------------------------------

### Set Initial Angle

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the initial rotation angles.

```text
Init_Angle = (0d, 0d, 0d), (360d, 360d, 360d)
```

--------------------------------

### Define SEQ Command Structure

Source: https://docs.pangya.golf/pc/file-formats/seq.md

The standard syntax for executing commands within a SEQ file, utilizing time-based triggers and comma-separated arguments.

```text
[time]: [command] = [comma-separated arguments, parenthesis-wrapped lists]
```

--------------------------------

### Define Ext_Orientation

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the orientation flags for x, y, and z axes using 0 or 1.

```text
Ext_Orientation = 1, 1, 1
```

--------------------------------

### Define Spray command

Source: https://docs.pangya.golf/pc/file-formats/seq/reference.md

Configures a spray effect with file, position, speed, and binding type.

```text
0000: Spray = xmas_roi.spr, (0, 0, 0), (0, 0, 0.), strongbond
```

--------------------------------

### Define Add_Rotation and Add_NRotation commands

Source: https://docs.pangya.golf/pc/file-formats/seq/reference.md

Configures rotation parameters including axis direction and angular velocity over time.

```text
:Add_Rotation = (1, 1, 1), (0, 2d, 50000, 2d)
```

```text
:Add_NRotation = (1, 1, 1), (0, 2d, 50000, 2d)
```

--------------------------------

### Define Add_Spawn command

Source: https://docs.pangya.golf/pc/file-formats/seq/reference.md

Adds a spawn event with various trigger conditions like interval, onground, ondeath, or age.

```text
:Add_spawn = airnight3_wave.spr, attached, (interval, 500, 20)
:Add_spawn = airnight3_wave.spr, attached, (onground)
:Add_spawn = airnight3_wave.spr, attached, (ondeath)
:Add_spawn = airnight3_wave.spr, attached, (age, 10)
```

--------------------------------

### Set Generation Parameters

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Configures item generation count and cone angle.

```text
Add_Generation = (0, 100), 30, 30d
```

--------------------------------

### Define Add_Wind

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the minimum and maximum rate for wind.

```text
Add_Wind = (0.03, 0.05)
```

--------------------------------

### Set Lighting Mode

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the lighting mode for the object.

```text
Lighting = Off
```

--------------------------------

### Define Add_Revolution and Add_PRevolution commands

Source: https://docs.pangya.golf/pc/file-formats/seq/reference.md

Configures revolution parameters including axis position, direction, and angular velocity over time.

```text
:Add_Revolution = ((0, 0, 0), (0, 1, 0)), (0, 1.0d, 20000, 1.0d)
```

```text
:Add_PRevolution = ((0, 0, 0), (1, 0, 0)), (0, 1.0d, 20000, 1.0d)
```

--------------------------------

### Add Flash Effect

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Configures a flash effect timing.

```text
Add_Flash = 0, 5, 10
```

--------------------------------

### Set Initial Frame

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the range for the initial animation frame.

```text
Init_Frame = (0, 2)
```

--------------------------------

### Set Size Animation

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Defines size changes over time using percentiles.

```text
Add_Size = (0 %, 90 %), (100 %, 150 %)
```

--------------------------------

### SPR Configuration Commands

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

A collection of commands used to define the properties of SPR files, including textures, animation, physics, and visual effects.

```APIDOC
## SPR Configuration Commands

### Source
Defines the texture or puppet source for the sprite.
- **File Name** (string) - The asset file name.
- **Sprite Width** (int) - Width of the sprite.
- **Sprite Height** (int) - Height of the sprite.
- **Billboard** (bool) - Optional, toggle billboard mode.

### Blend
Sets the blending mode for the sprite and its tail.
- **Blend Mode** (enum: Normal, Add, Multiply, InvMultiply)
- **Tail Blend Mode** (enum: Normal, Add, Multiply, InvMultiply)

### Lighting
Sets the lighting mode.
- **Lighting Mode** (enum: Off, Diffuse, Ambient1, Ambient2)

### GenPos
Defines the Axis-aligned bounding box (AABB) for generation.
- **Min AABB** (x, y, z)
- **Max AABB** (x, y, z)

### Init_Size
Sets the initial size parameters.
- **Minimal Size** (float)
- **Maximum Size** (float)
- **Ratio** (float)

### Add_Size
Defines size changes over time.
- **Start Time** (percentile)
- **Start Size** (percentile)
- **End Time** (percentile)
- **End Size** (percentile)

### Init_Frame
Sets the initial animation frame range.
- **Minimal Frame** (int)
- **Maximum Frame** (int)

### Add_Frame
Defines frame animation transitions.
- **Start Time** (percentile)
- **End Time** (percentile)
- **Start Frame** (int)
- **End Frame** (int)
- **Transition Time** (ms/frames)

### Add_Generation
Configures particle generation.
- **Start Frame** (int)
- **End Frame** (int)
- **Count** (int)
- **Angle** (deg/rad)

### LifeTime
Sets the particle lifetime range.
- **Min Lifetime** (ms/frames)
- **Max Lifetime** (ms/frames)

### Add_Fade
Configures color fading over time.
- **Start Time** (percentile)
- **Start Color** (ARGB_255)
- **End Time** (percentile)
- **End Color** (ARGB_255)

### Init_Velocity
Sets initial velocity vectors.
- **Min Velocity** (x, y, z)
- **Max Velocity** (x, y, z)

### Add_Velocity
Defines velocity changes over time.
- **Start Time** (ms/frames)
- **Start Velocity** (percentile)
- **End Time** (ms/frames)
- **End Velocity** (percentile)

### Tail
Configures tail effects.
- **Length** (int)
- **Interval** (ms/frames)
- **End Color** (ARGB_255)
- **Texture** (string)
- **Width** (int)
- **Status** (string)
- **Facing** (string)

### Friction / GroundFriction
Sets friction coefficients.
- **Friction** (float)

### Gravity
Sets global gravity vector.
- **Direction** (x, y, z)

### Add_GravityPoint
Adds a point-based gravity source.
- **Position** (x, y, z)
- **Intensity** (float)
- **Range** (float)
- **Out-of-Range Intensity** (float)
```

--------------------------------

### Define BoneInformation structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines bone attachment and weight, read until total weight equals 255.

```csharp
struct BoneInformation
{
  byte Weight;
  byte BoneID;
}
```

--------------------------------

### Define Version Structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the versioning information found in the VERS section.

```csharp
struct Version
{
  byte Minor;
  byte Major;
}
```

--------------------------------

### IFF Header Structure

Source: https://docs.pangya.golf/pc/file-formats/iff.md

Defines the initial header structure found at the beginning of every IFF file.

```csharp
struct IFFHeader
{
    ushort RecordCount;
    ushort BindingID;
    uint   Version;
}
```

--------------------------------

### Set Initial Velocity

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the initial velocity vector range.

```text
Init_Velocity = (0, 0.2, 0), (0, 0.5, 0)
```

--------------------------------

### Define Texture Source

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Configures the texture file and sprite dimensions.

```text
Source = [Explode.jpg, 32, 32
```

--------------------------------

### TALK File Format Syntax

Source: https://docs.pangya.golf/pc/file-formats/talk.md

Defines the structure of each line in a TALK file.

```text
[event]:[value]:[text]
```

--------------------------------

### Set Initial Rotation

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the initial angular velocity.

```text
Init_Rotation = (-10d, -10d, -10d), (10d, 10d, 10d)
```

--------------------------------

### SPR Command Syntax

Source: https://docs.pangya.golf/pc/file-formats/spr.md

The standard structure for defining commands in an SPR file, using comma-separated arguments and parenthesis-wrapped lists.

```text
[command] = [comma-separated arguments, parenthesis-wrapped lists]
```

--------------------------------

### Set Tail Properties

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Configures the visual tail effect for the sprite.

```text
Tail = 10, 3f, (255, 0, 0, 0), ~ball_straight.jpg, 90, monolith, cameraside
```

--------------------------------

### Set Ground Friction

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the ground friction coefficient.

```text
GroundFriction = 0.1
```

--------------------------------

### Set Friction

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the friction coefficient.

```text
Friction = 0.003
```

--------------------------------

### Define stop command

Source: https://docs.pangya.golf/pc/file-formats/seq/reference.md

Stops execution at the specified timestamp.

```text
29000: stop
```

--------------------------------

### Define Add_Bubble

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Configures bubble motion parameters including amplitude and frequency for three axes.

```text
Add_Bubble = (0, 0), (0.003, 2.2), (0.003, 2)
```

--------------------------------

### Set Gravity

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the global gravity vector.

```text
Gravity = (0, -0.01, 0)
```

--------------------------------

### Define FileEntry structure in C#

Source: https://docs.pangya.golf/psp/file-formats/pak.md

Represents the structure of individual file entries found within the psppackfilelist.pak file.

```csharp
public struct FileEntry
{
    public ushort Type;
    public ushort Unknown1;
    public uint Offset;
    public uint FileSize;
    public uint RealFileSize;
    public string FileName;
}
```

--------------------------------

### Set Ground Collision

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Configures ground height and collision properties.

```text
Ground = 0, 1%, 0
```

--------------------------------

### PAK Header Structure

Source: https://docs.pangya.golf/pc/file-formats/pak.md

Defines the footer structure located at the end of the PAK file.

```csharp
struct PAKHeader
{
    uint FileListOffset;
    uint FileCount;
    byte Signature;
}
```

--------------------------------

### Add Quake Effect

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Adds a screen or object shake effect.

```text
Add_Quake = (0, 0, 0), (1000, (0, 0, 0)), (2000, (0, 0, 0))
```

--------------------------------

### Define UVMapping structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines U/V texture projection coordinates.

```csharp
struct UVMapping
{
  float U;
  float V;
}
```

--------------------------------

### PAK File Entry Structure

Source: https://docs.pangya.golf/pc/file-formats/pak.md

Defines the structure for individual file entries within the archive's file list.

```csharp
struct PAKFileEntry
{
    byte FileNameLength;
    byte Compression;
    uint Offset;
    uint FileSize;
    uint RealFileSize;
    string FileName;
}
```

--------------------------------

### Set Volume Core

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the horizontal and vertical scale for the volume core.

```text
Vol_Core = (0.85, 0.8)
```

--------------------------------

### Add Gravity Point

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Adds a localized gravity point.

```text
Add_GravityPoint = (0, 0, 0), 0, 0, 0.03
```

--------------------------------

### Define PET Section Header

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the standard header structure for all sections in a PET file.

```csharp
struct PETSectionHeader 
{
  string Name;
  uint Length;
}
```

--------------------------------

### Define AttachedToParent command

Source: https://docs.pangya.golf/pc/file-formats/seq/reference.md

Sets the dependency state and axis constraints for an object attached to a parent.

```text
:AttachedToParent = on, (1, 1, 1)
```

--------------------------------

### Define QSTDialogue structure in C#

Source: https://docs.pangya.golf/psp/file-formats/qst.md

Represents the dialogue structure found in QST files. Note that CharacterID and Position fields are based on assumptions.

```csharp
public struct QSTDialogue 
{
    public byte EventID;
    public byte ID;
    public byte CharacterID;
    public byte Position;
    public string CharacterImage; // 32 bytes
    public string BackgroundImage; // 32 bytes
    public string Text; // 192 bytes
}
```

--------------------------------

### Define Ext_Wind

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the positional wind vector for x, y, and z.

```text
Ext_Wind = (1, 0, 0)
```

--------------------------------

### Set Camera Offset

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the offset relative to the camera.

```text
CamOffset = 0.1
```

--------------------------------

### Set Frame Animation

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Defines frame animation timing and transitions.

```text
Add_Frame = (0%, 100%), (0, 15, 1f)
```

--------------------------------

### Set Fade Animation

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Defines color fading over time using ARGB values.

```text
Add_Fade = (0 %, (255, 255, 100, 100)), (100 %, (255, 255, 100, 100))
```

--------------------------------

### Set Blend Mode

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Defines the blend mode for the sprite and its tail.

```text
Blend = Add, Add
```

--------------------------------

### Set Velocity Animation

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Defines velocity changes over time.

```text
Add_Velocity = (0, 100 %), (5000, 0 %)
```

--------------------------------

### Common IFF Data Structure

Source: https://docs.pangya.golf/pc/file-formats/iff.md

Represents the standard data fields present in most IFF records, excluding specific exceptions.

```csharp
struct IFFCommon
{
    public uint Active;
    public uint ID;
    public string Name;
    public byte Level;
    public string Icon;
    public uint Price;
    public uint DiscountPrice;
    public uint UsedPrice;
    public byte ShopFlag;
    public byte MoneyFlag;
    public byte TimeFlag;
    public byte TimeByte;
    public uint Point;
    public _SYSTEMTIME StartTime;
    public _SYSTEMTIME EndTime;
}
```

--------------------------------

### Define Vol_Max_Opacity

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the maximum opacity value for the volume.

```text
Vol_Max_Opacity = 0.5
```

--------------------------------

### Define Dist_Limit

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the distance limits for x and y coordinates.

```text
Dist_Limit = 300, 400
```

--------------------------------

### Set Lifetime

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the minimum and maximum lifetime for generated items.

```text
LifeTime = (40f, 60f)
```

--------------------------------

### Set Rotation Animation

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Defines angular velocity changes over time.

```text
Add_Rotation = (0%, 100%), (100%, 100%)
```

--------------------------------

### Define Texture Structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the texture data structure. Read 44 bytes per texture and split at the first null-byte to extract the name.

```csharp
struct Texture
{
  string TextureName;
}
```

--------------------------------

### Define Frame structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines frame-based animation sequence data.

```csharp
struct Frame
{
  uint Index;
  string Script;
  float X;
  float Y;
  float Z;
}
```

--------------------------------

### Define CollisionBox structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the collision box data for a model. Note that version 1.0 files require an additional byte read after the BoneName field.

```csharp
struct CollisionBox
{
  uint Unknown1;
  uint Unknown2;
  string Name;
  string BoneName;
  uint Unknown3;
  uint Unknown4;
  float MinX;
  float MinY;
  float MinZ;
  float MaxX;
  float MaxY;
  float MaxZ;
}
```

--------------------------------

### Define Animation structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the core animation data structure for a bone.

```csharp
struct Animation
{
  byte BoneID;
  PositionData[] PositionData;
  RotationData[] RotationData;
  ScalingData[] ScalingData;
  AnimationFlag[] AnimationFlag;
}
```

--------------------------------

### Define AnimationFlag structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines animation flags for version 1.3 models.

```csharp
struct AnimationFlag
{
  float Time;
  float Value;
}
```

--------------------------------

### Define Mesh structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the primary mesh container for vertices and polygons.

```csharp
struct Mesh
{
  Vertex[] Vertices;
  Polygon[] Polygons;
}
```

--------------------------------

### Define IsSphere

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the shape type where 0 is a box and 1 is a sphere.

```text
IsSphere = 1
```

--------------------------------

### Define PolygonIndex structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines the corner position and UV mapping for a polygon.

```csharp
struct PolygonIndex
{
  uint Index;
  float X;
  float Y;
  float Z;
  UVMapping[] UVMapping;
}
```

--------------------------------

### Define Motion structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the frame-based animation structure. Each string property is preceded by an unsigned integer indicating its length.

```csharp
struct Motion
{
  string Name;
  uint FrameStart;
  uint FrameEnd;
  string TargetName;
  string TypeName;
  string BoneName;
}
```

--------------------------------

### Define Vertex structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines a single vertex with associated bone information.

```csharp
struct Vertex
{
  float X;
  float Y;
  float Z;
  BoneInformation[] BoneInformation;
}
```

--------------------------------

### Define Bone Structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Represents the bone data structure. Version 1.3 includes an additional unknown float value after the matrix.

```csharp
struct Bone
{
  string Name; // null-byte delimited string
  byte Parent;
  float[12] Matrix;
}
```

--------------------------------

### Define Polygon structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines a polygon consisting of three indices and a texture index.

```csharp
struct Polygon
{
  PolygonIndex[3] PolygonIndices;
  byte TextureIndex;
}
```

--------------------------------

### Define RegenAtSamePos

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Sets the boolean flag for regeneration at the same position.

```text
RegenAtSamePos = 1
```

--------------------------------

### Define PositionData structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines the positional coordinates of a bone at a specific time.

```csharp
struct PositionData
{
  float Time;
  float X;
  float Y;
  float Z;
}
```

--------------------------------

### Define RotationData structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines the quaternion rotation of a bone at a specific time.

```csharp
struct RotationData
{
  float X;
  float Y;
  float Z;
  float W;
  float Time;
}
```

--------------------------------

### Set Generation Position

Source: https://docs.pangya.golf/pc/file-formats/spr/reference.md

Defines the AABB for the generation position.

```text
GenPos = (0, 0, 0), (0, 0, 0)
```

--------------------------------

### Define ScalingData structure

Source: https://docs.pangya.golf/pc/file-formats/pet.md

Defines the axis scale of a bone at a specific time, used in version 1.2 and above.

```csharp
struct ScalingData
{
  float Time;
  float X;
  float Y;
  float Z;
}
```
Tokens:
Raw