Fix and add missing javadocs in MappingData interface (#4202)

This commit is contained in:
EnZaXD 2024-10-26 18:55:08 +02:00 committed by GitHub
parent 65b76d53ef
commit 009b6c810c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -35,56 +35,82 @@ public interface MappingData {
void load(); void load();
/** /**
* Returns the mapped block state id, or -1 if unmapped. * Returns the mapped block state id, or 0 if unmapped.
* *
* @param id unmapped block state id * @param id unmapped block state id
* @return mapped block state id, or -1 if unmapped * @return mapped block state id, or 0 if unmapped
* @throws NullPointerException if this mappingdata does not hold block state mappings * @throws NullPointerException if this mappingdata does not hold block state mappings
*/ */
int getNewBlockStateId(int id); int getNewBlockStateId(int id);
/** /**
* Returns the mapped block id, or -1 if unmapped. * Returns the mapped block id, or 0 if unmapped.
* *
* @param id unmapped block id * @param id unmapped block id
* @return mapped block id, or -1 if unmapped * @return mapped block id, or 0 if unmapped
* @throws NullPointerException if this mappingdata does not hold block mappings * @throws NullPointerException if this mappingdata does not hold block mappings
*/ */
int getNewBlockId(int id); int getNewBlockId(int id);
/**
* Returns the backwards mapped block id, or 1 if unmapped.
*
* @param id mapped block id
* @return backwards mapped block id, or 1 if unmapped
*/
int getOldBlockId(int id); int getOldBlockId(int id);
/** /**
* Returns the mapped item id, or -1 if unmapped. * Returns the mapped item id, or 0 if unmapped.
* *
* @param id unmapped item id * @param id unmapped item id
* @return mapped item id, or -1 if unmapped * @return mapped item id, or 0 if unmapped
* @throws NullPointerException if this mappingdata does not hold item mappings * @throws NullPointerException if this mappingdata does not hold item mappings
*/ */
int getNewItemId(int id); int getNewItemId(int id);
/** /**
* Returns the backwards mapped item id, or -1 if unmapped. * Returns the backwards mapped item id, or 1 if unmapped.
* *
* @param id mapped item id * @param id mapped item id
* @return backwards mapped item id, or -1 if unmapped * @return backwards mapped item id, or 1 if unmapped
* @throws NullPointerException if this mappingdata does not hold item mappings * @throws NullPointerException if this mappingdata does not hold item mappings
*/ */
int getOldItemId(int id); int getOldItemId(int id);
/** /**
* Returns the mapped particle id, or -1 if unmapped. * Returns the mapped particle id, or 0 if unmapped.
* *
* @param id unmapped particle id * @param id unmapped particle id
* @return mapped particle id, or -1 if unmapped * @return mapped particle id, or 0 if unmapped
* @throws NullPointerException if this mappingdata does not hold particle mappings * @throws NullPointerException if this mappingdata does not hold particle mappings
*/ */
int getNewParticleId(int id); int getNewParticleId(int id);
/**
* Returns the mapped attribute id, or 0 if unmapped.
*
* @param id unmapped attribute id
* @return mapped attribute id, or 0 if unmapped
* @throws NullPointerException if this mappingdata does not hold attribute mappings
*/
int getNewAttributeId(int id); int getNewAttributeId(int id);
/**
* Returns the mapped sound id, or 0 if unmapped.
*
* @param id unmapped sound id
* @return mapped sound id, or 0 if unmapped
* @throws NullPointerException if this mappingdata does not hold sound mappings
*/
int getNewSoundId(int id); int getNewSoundId(int id);
/**
* Returns the backwards mapped sound id, or 1 if unmapped.
*
* @param i mapped sound id
* @return backwards mapped sound id, or 1 if unmapped
*/
int getOldSoundId(int i); int getOldSoundId(int i);
/** /**